Documentazione di Oracle Cloud Infrastructure

Esecuzione di un caricamento multiparte

In Compute Cloud@Customer è possibile caricare gli oggetti in più parti.

Con i caricamenti multiparte, è possibile caricare in parallelo singole parti di un oggetto per ridurre il tempo impiegato per il caricamento.

I caricamenti multiparte contengono oggetti troppo grandi per una singola operazione di caricamento. Le parti dell'oggetto non devono essere maggiori di 50 GiB.

È possibile sospendere tra i caricamenti di singole parti e riprendere il caricamento quando la pianificazione e le risorse lo consentono.

Parti oggetto

Con il caricamento multiparte, puoi suddividere l'oggetto che desideri caricare in singole parti. Le singole parti possono essere grandi come 50 GiB. La dimensione massima per un oggetto caricato è 10 TiB.

Decidere il numero di particolare che si desidera utilizzare per ogni parte. I numeri di parte possono variare da 1 a 10.000. Non è necessario assegnare numeri contigui, ma lo storage degli oggetti crea l'oggetto ordinando i numeri parte in ordine crescente.

API caricamento multiparte

Prima di utilizzare l'API di caricamento multiparte, si è responsabili della creazione delle parti da caricare. Lo storage degli oggetti fornisce operazioni API per i passi rimanenti.

Un caricamento multiparte eseguito mediante l'API è costituito dai passi riportati di seguito.

  1. Avviare un caricamento.

  2. Carica parti oggetto.

  3. Eseguire il commit del caricamento.

Il servizio fornisce inoltre operazioni API per elencare i caricamenti multiparte in corso, elencare le parti dell'oggetto in un caricamento multiparte in corso e interrompere i caricamenti multiparte in corso avviati tramite l'API.

CLI caricamento multiparte

Quando esegui un caricamento multiparte utilizzando l'interfaccia CLI, non è necessario suddividere l'oggetto in parti come richiesto dall'interfaccia API. In alternativa, puoi specificare la dimensione della parte desiderata e lo storage degli oggetti suddivide l'oggetto in parti ed esegue automaticamente il caricamento di tutte le parti. È possibile scegliere di impostare il numero massimo di parti che è possibile caricare in parallelo. Per impostazione predefinita, l'interfaccia CLI limita il numero di parti che possono essere caricate in parallelo a tre. Quando si utilizza l'interfaccia CLI, non è necessario eseguire un commit al termine del caricamento.

Puoi anche utilizzare l'interfaccia CLI per elencare i caricamenti multiparte in corso e per annullare i caricamenti multiparte avviati tramite l'interfaccia API.

  • Task non disponibile nella console.

  • Utilizzare il comando oci os object put e i parametri richiesti per caricare un oggetto in più parti.

    Sintassi:

    oci os object put --namespace-name <object_storage_namespace> --bucket-name <bucket_name> --file <file_location> --parallel-upload-count <maximum_number_parallel_uploads> --part-size <upload_part_size_in_MB> --force [OPTIONS]

    Ad esempio:

    oci os object put   \
--namespace-name examplenamespace  \
--file /boot/initramfs-0-rescue-e542c19f0fbf4e41a41428d933a7357f.img   \
--parallel-upload-count 5   \
--part-size 15   \
--force

Upload ID: a21bba2c-8922-4b9c-a98a-9ef3569c0138
Split file into 6 parts for upload.
Uploading object [####################################] 100%
{
  "etag": "0964effc8dc4394fd317f03a025ae5d0",
  "last-modified": "2021-05-11T21:35:19",
  "opc-multipart-md5": "UIVRhiwSHY6o0E4pi/yfGg==-6"
}

    Per un elenco completo dei comandi, dei flag e delle opzioni dell'interfaccia CLI, vedere Command Line Reference.

  • Un caricamento multiparte eseguito mediante l'API è costituito dai passi riportati di seguito.

    1. Avvio di un caricamento.
    2. Caricamento delle parti dell'oggetto.
    3. Commit del caricamento in corso.

    Prima di utilizzare l'API di caricamento multiparte, è necessario creare le parti da caricare. Lo storage degli oggetti fornisce operazioni API per i passi rimanenti. Il servizio fornisce inoltre operazioni API per elencare i caricamenti multiparte in corso, elencare le parti dell'oggetto in un caricamento multiparte in corso e interrompere i caricamenti multiparte in corso avviati tramite l'API.

    Nota

    Questi requisiti API di caricamento multiparte non si applicano all'interfaccia CLI.

    Per ulteriori informazioni sull'utilizzo dell'API di caricamento multiparte, vedere Utilizzo dell'API di caricamento multiparte.

    Utilizzare l'operazione PutObject per caricare un oggetto in più parti.

    Per informazioni sull'uso dell'API e delle richieste di firma, vedere API REST e Credenziali di sicurezza. Per informazioni sugli SDK, vedere Software Development Kits and Command Line Interface.