Questa pagina descrive i caricamenti in più parti dell'API XML in Cloud Storage. Questo metodo di caricamento carica i file in parti e poi li assembla in un unico oggetto utilizzando una richiesta finale. I caricamenti multiparte dell'API XML sono compatibili con i caricamenti multiparte di Amazon S3.
Panoramica
Un caricamento multiparte dell'API XML consente di caricare i dati in più parti e poi assemblarli in un oggetto finale. Questo comportamento presenta diversi vantaggi, in particolare 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 ricaricare solo una parte dell'oggetto complessivo, anziché ricominciare dall'inizio.
Poiché le dimensioni totali del file non sono specificate in anticipo, puoi utilizzare i caricamenti in più parti dell'API XML per i caricamenti in streaming o per comprimere i dati al volo durante il caricamento.
Un 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 un limite al tempo per cui un caricamento multiparte e le relative parti caricate possono rimanere non completati o inattivi in un bucket.
Considerazioni
Si applicano le seguenti limitazioni all'utilizzo dei caricamenti in più parti dell'API XML:
- Esistono limiti per le dimensioni minime e massime di una parte e per il numero di parti utilizzate per assemblare il caricamento completato.
- Le precondizioni 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 Trusted Cloud o nell&Google Cloud CLI.
Quando utilizzi i caricamenti multiparte dell'API XML, tieni presente quanto segue:
I caricamenti multiparte dell'API XML hanno autorizzazioni IAM specifiche. Se utilizzi ruoli IAM personalizzati, devi assicurarti che questi ruoli dispongano delle autorizzazioni necessarie.
Anche se puoi avviare un caricamento e caricare le parti, la richiesta di completamento del caricamento non va a buon fine se sovrascriverebbe un oggetto su cui è presente un blocco o un periodo di conservazione non soddisfatto.
Puoi elencare i caricamenti in corso in un bucket, ma solo un caricamento completato viene visualizzato nel normale elenco di oggetti nel bucket.
In che modo le librerie client utilizzano i caricamenti multiparte dell'API XML
Questa sezione fornisce informazioni sull'esecuzione di caricamenti in più parti dell'API XML con librerie client che lo supportano.
Librerie client
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
La libreria client Java non supporta i caricamenti in più parti dell'API XML. Utilizza invece i caricamenti compositi paralleli.
Node.js
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Puoi eseguire caricamenti multiparte dell'API XML utilizzando il metodo
uploadFileInChunks
. Ad esempio:
Python
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
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 a inviare le richieste.