Documentazione dell'infrastruttura Oracle Cloud

Esecuzione di un caricamento multiparte

In Compute Cloud@Customer, puoi caricare gli oggetti in più parti.

Con i caricamenti multiparte, le singole parti di un oggetto possono essere caricate in parallelo per ridurre la quantità di tempo che trascorri a caricare.

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

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

Parti oggetto

Con il caricamento multiparte, dividi 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 parte 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 costruisce l'oggetto ordinando i numeri di parte in ordine crescente.

API di caricamento multiparte

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

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

  1. Consente di avviare un caricamento.

  2. Carica parti oggetto.

  3. Eseguire il commit del caricamento.

Il servizio fornisce anche operazioni API per elencare i caricamenti multiparte in corso, elencare le parti 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 dividere l'oggetto in parti come richiesto dall'API. Invece, puoi specificare la dimensione della parte desiderata e lo storage degli oggetti divide 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 è possibile caricare 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'API.

  • Questo 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]

    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 di comandi, flag e opzioni dell'interfaccia CLI, vedere Riferimento per la riga di comando.

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

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

    Prima di utilizzare l'API di caricamento multiparte, sei responsabile della creazione delle parti da caricare. Lo storage degli oggetti fornisce operazioni API per i passi rimanenti. Il servizio fornisce anche operazioni API per elencare i caricamenti multiparte in corso, elencare le parti oggetto in un caricamento multiparte in corso e interrompere i caricamenti multiparte in corso avviati tramite l'API.

    Nota

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

    Per ulteriori informazioni sull'uso dell'API di caricamento multiparte, vedere Uso dell'API di caricamento multiparte.

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

    Per informazioni sull'uso dell'API e sulle richieste di firma, vedere API REST e Credenziali di sicurezza. Per informazioni sugli SDK, vedere Software Development Kit and Command Line Interface (interfaccia a riga di comando e kit di sviluppo software).