Caricamenti multiparte dell'API XML

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina illustra i caricamenti a più parti dell'API XML in Cloud Storage. Questo metodo di caricamento consente di caricare i file in parti e quindi di assemblarle 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 XML a più parti dell'API ti consente di caricare i dati in più parti per poi assemblarle 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 il caricamento completo dei dati.

  • Se una delle operazioni di caricamento ha esito negativo, devi solo ricaricare una parte dell'oggetto complessivo, invece di ricominciare dall'inizio.

  • Poiché la dimensione totale del file non viene specificata in anticipo, puoi utilizzare caricamenti multiparte dell'API XML per i caricamenti in streaming o per la compressione immediata di dati.

Il caricamento di più parti dell'API XML prevede tre passaggi obbligatori:

  1. Avvia il caricamento utilizzando una richiesta POST, che includa di specificare qualsiasi metadati necessario all'oggetto completato. La risposta restituisce un elemento UploadId che utilizzi in tutte le richieste successive associate al caricamento.

  2. Carica i dati utilizzando una o più richieste PUT. Tieni presente che sono previsti dei limiti al numero di parti e alle dimensioni.

  3. 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 a più parti e le sue parti caricate possono rimanere non completate o inattive in un bucket, ma tieni presente che le parti caricate correttamente vengono conteggiate per l'utilizzo mensile dello spazio di archiviazione. Per evitare l'accumulo di caricamenti a più parti abbandonati, utilizza la Gestione del ciclo di vita degli oggetti per rimuovere automaticamente i caricamenti a più parti quando raggiungono un'età specificata.

Considerazioni

L'utilizzo dei caricamenti a più parti dell'API XML prevede le seguenti limitazioni:

  • Un oggetto caricato utilizzando questo metodo non può essere copiato o riscritto, a meno che non componi l'oggetto prima della copia o della riscrittura.
  • Le condizioni preliminari non sono supportate nelle richieste.
  • Non esistono hash MD5 per gli oggetti caricati utilizzando questo metodo.
  • Questo metodo di caricamento non è supportato nelle librerie client di Google Cloud Console, Google Cloud CLI o Cloud Storage.
  • La replica turbo non si applica agli oggetti caricati utilizzando questo metodo.

Quando lavori con caricamenti a più parti dell'API XML, tieni presente quanto segue:

  • Anche se puoi avviare un caricamento e caricare le relative parti, la richiesta di completamento del caricamento avrà esito negativo se sovrascriverà 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 viene visualizzato nell'elenco di normali oggetti del bucket.

  • Le parti caricate sono soggette a costi di eliminazione anticipata se utilizzano una classe di archiviazione applicabile e si verifica una delle seguenti condizioni prima che la parte raggiunga la durata minima di archiviazione:

    • Il caricamento viene completato, ma la parte non viene utilizzata nella richiesta di completamento.
    • La parte viene sovrascritta da un'altra parte caricata.
    • Il caricamento complessivo di più parti viene interrotto, direttamente o tramite la gestione del ciclo di vita degli oggetti.

    La durata dello spazio di archiviazione di ogni parte nel caricamento di più parti inizia al momento del completamento del caricamento della parte.

Passaggi successivi