Questa pagina illustra i caricamenti multiparte delle API XML in Cloud Storage. Questo metodo di caricamento carica i file in parti e quindi li assembla in un singolo oggetto utilizzando una richiesta finale. I caricamenti multiparte API XML sono compatibili con i caricamenti multiparte di Amazon S3.
Panoramica
Il caricamento multiparte dell'API XML consente di caricare i dati in più parti per poi 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, devi solo ricaricare 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.
Un caricamento multiparte in un'API XML prevede tre passaggi obbligatori:
Avvia il caricamento utilizzando una richiesta
POST
, che include la specifica di tutti i metadati che dovrebbero essere presenti nell'oggetto completato. La risposta restituisce un elementoUploadId
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 per cui un caricamento multiparte e le relative parti caricate possono rimanere non completate o inattive in un bucket.
- Le parti caricate correttamente vengono conteggiate ai fini dell'utilizzo mensile dello spazio di archiviazione.
- Puoi evitare l'accumulo di caricamenti multiparte abbandonati utilizzando Gestione del ciclo di vita degli oggetti per rimuovere automaticamente i caricamenti con più parti al raggiungimento di una determinata età.
Considerazioni
All'utilizzo dei caricamenti multiparte dell'API XML si applicano le seguenti limitazioni:
- Esistono dei limiti relativi alle dimensioni minime di un componente, alle dimensioni massime di un componente e al numero di parti utilizzate per assemblare il caricamento completato.
- Le condizioni preliminari non sono supportate nelle richieste.
- Gli hash MD5 non esistono per gli oggetti caricati utilizzando questo metodo.
- Questo metodo di caricamento non è supportato nella console Google Cloud o in Google Cloud CLI.
Tieni presente quanto segue quando lavori con i caricamenti multiparte dell'API XML:
I caricamenti multiparte dell'API XML hanno autorizzazioni IAM specifiche. Se utilizzi ruoli IAM personalizzati, devi assicurarti che abbiano le autorizzazioni necessarie.
Anche se puoi avviare un caricamento e un caricamento di parti, la richiesta di completare il caricamento non va a buon fine se sovrascriverebbe un oggetto con un blocco o un periodo di conservazione non completato.
Puoi elencare i caricamenti in corso in un bucket, ma solo un caricamento completato apparirà nel normale elenco di oggetti nel bucket.
Una parte caricata può essere soggetta ad addebiti per l'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 le librerie client che la supportano.
Librerie client
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
La libreria client Java non supporta i caricamenti multiparte API XML. Utilizza invece i caricamenti compositi paralleli.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su 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 ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su 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.