Questa pagina illustra i caricamenti multiparte dell'API XML in Cloud Storage. Questo metodo di caricamento consente di caricare i file in parti, quindi li assembla in un singolo oggetto utilizzando una richiesta finale. I caricamenti multiparte dell'API XML sono compatibili con i caricamenti multiparte di Amazon S3.
Panoramica
Un caricamento multiparte XML dell'API ti consente di caricare dati in più parti e quindi di assemblarli in un oggetto finale. Questo comportamento offre diversi vantaggi, soprattutto per i file di grandi dimensioni:
Puoi caricare le parti contemporaneamente, riducendo il tempo necessario per caricare i dati nella loro interezza.
Se una delle operazioni di caricamento non va a buon fine, dovrai ricaricare solo una parte dell'oggetto complessivo, anziché riavviare dall'inizio.
Poiché le dimensioni totali del file non vengono specificate in anticipo, puoi utilizzare i caricamenti multiparte dell'API XML per i caricamenti in streaming o per comprimere i dati in tempo reale durante il caricamento.
Il caricamento multiparte dell'API XML prevede tre passaggi obbligatori:
Avvia il caricamento utilizzando una richiesta
POST
, che include la specifica di tutti i metadati che l'oggetto completato deve avere. La risposta restituisce unUploadId
che utilizzi in tutte le richieste successive associate al caricamento.Carica i dati utilizzando una o più richieste
PUT
.Completa il caricamento utilizzando una richiesta
POST
. Questa richiesta sovrascrive qualsiasi oggetto esistente nel bucket con lo stesso nome.
Non esiste alcun limite al tempo di un caricamento con più parti e delle sue parti caricate possono rimanere non completati o inattive in un bucket.
- Le parti caricate correttamente vengono conteggiate ai fini dell'utilizzo mensile dello spazio di archiviazione.
- Puoi evitare un accumulo di caricamenti multiparte abbandonati utilizzando Gestione del ciclo di vita degli oggetti per rimuovere automaticamente i caricamenti multiparte quando raggiungono una determinata età.
Considerazioni
All'utilizzo dei caricamenti multiparte dell'API XML si applicano le seguenti limitazioni:
- Esistono dei limiti alle dimensioni minime di una parte, alle dimensioni massime consentite di una parte e al numero di parti utilizzate per assemblare il caricamento completato.
- Le precondizioni non sono supportate nelle richieste.
- Non esistono hash MD5 per gli oggetti caricati con questo metodo.
- Questo metodo di caricamento non è supportato nella console Google Cloud o in Google Cloud CLI.
Tieni presente quanto segue quando utilizzi i caricamenti multiparte sull'API XML:
I caricamenti multiparte dell'API XML hanno autorizzazioni IAM specifiche. Se utilizzi ruoli IAM personalizzati, devi assicurarti che questi ruoli abbiano le autorizzazioni necessarie.
Anche se puoi avviare un caricamento e caricare parti, la richiesta di completare il caricamento non riesce se sovrascrive un oggetto con blocco o un periodo di conservazione non soddisfatto.
Puoi elencare i caricamenti in corso in un bucket, ma nel normale elenco di oggetti nel bucket viene visualizzato solo un caricamento completato.
Una parte caricata può essere soggetta a costi di eliminazione anticipata se non viene mai utilizzata.
In che modo le librerie client utilizzano i caricamenti multiparte dell'API XML
Questa sezione fornisce informazioni sull'esecuzione di caricamenti multiparte dell'API XML con librerie client che la supportano.
Librerie client
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Puoi eseguire caricamenti multiparte dell'API XML utilizzando il metodo
uploadFileInChunks
. Ad esempio:
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Puoi eseguire caricamenti multiparte dell'API XML utilizzando il metodo
upload_chunks_concurrently
. Ad esempio:
Passaggi successivi
- Esplora altri metodi di caricamento per Cloud Storage.
- Scopri di più sul backoff esponenziale troncato e su quando riprovare le richieste.