Questa pagina illustra i concetti relativi al caricamento degli oggetti. Puoi caricare e archiviare qualsiasi tipo MIME di dati fino a 5 TiB di dimensioni.
Tipi di caricamento
Puoi inviare richieste di caricamento a Cloud Storage nei seguenti modi:
Caricamento con una sola richiesta. Un metodo di caricamento in cui un oggetto viene caricato come singola richiesta. Utilizza questa opzione se il file è abbastanza piccolo da essere caricato interamente in caso di errore di connessione. Consulta Carica oggetto da file o Carica oggetto dalla memoria per le guide ai caricamenti con una sola richiesta.
- Caricamento in più parti dell'API JSON. Un metodo di caricamento che ti consente di caricare sia i dati dell'oggetto sia i relativi metadati in un'unica richiesta. L'API XML, invece, consente di impostare i metadati degli oggetti in tutti i tipi di caricamento.
Caricamento ripristinabile. Un metodo di caricamento che offre un trasferimento più affidabile, il che è particolarmente importante con i file di grandi dimensioni. I caricamenti ripristinabili sono una buona scelta per la maggior parte delle applicazioni, in quanto funzionano anche per i file di piccole dimensioni al costo di una richiesta HTTP aggiuntiva per caricamento. Puoi anche utilizzare i caricamenti ripristinabili per eseguire trasferimenti in streaming, che ti consentono di caricare un oggetto di dimensioni sconosciute.
Caricamento in più parti dell'API XML. Un metodo di caricamento compatibile con i caricamenti in più parti di Amazon S3. I file vengono caricati in più parti e assemblati in un unico oggetto con la richiesta finale. I caricamenti multiparte dell'API XML consentono di caricare le parti in parallelo, riducendo potenzialmente il tempo necessario per completare il caricamento complessivo.
Utilizzando questi tipi di caricamento di base, è possibile implementare strategie di caricamento più avanzate:
Caricamento parallelo di composizioni. Una strategia di caricamento in cui dividi un file e carichi i blocchi in parallelo. A differenza dei caricamenti multiparte dell'API XML, i caricamenti compositi paralleli utilizzano l'operazione di composizione e l'oggetto finale viene archiviato come oggetto composito.
Caricamento streaming. Un metodo di caricamento che ti consente di caricare i dati senza richiedere che vengano prima salvati in un file, il che è utile quando non conosci le dimensioni totali del caricamento all'inizio.
Caricamento con codifica di trasferimento chunked. Un caricamento con una sola richiesta che include l'intestazione
Transfer-Encoding: chunked, consentendo l'invio del caricamento in più blocchi di dati sequenziali.
Considerazioni sulle dimensioni di caricamento
Quando scegli se utilizzare un caricamento con una sola richiesta anziché un caricamento ripristinabile o un caricamento multiparte dell'API XML, considera la quantità di tempo che sei disposto a perdere in caso di errore di rete e se devi riavviare il caricamento dall'inizio. Per connessioni più veloci, le dimensioni del limite possono in genere essere maggiori.
Ad esempio, supponiamo che tu sia disposto a tollerare 30 secondi di tempo perso:
Se esegui il caricamento da un sistema locale con una velocità di caricamento media di 8 Mbps, puoi utilizzare i caricamenti con una sola richiesta per file di dimensioni fino a 30 MB.
Se carichi contenuti da un servizio nella stessa regione con una velocità di caricamento media di 500 Mbps, la dimensione limite per i file è quasi 2 GB.
Supporto per strumento
Console
Quando utilizzi la consoleCloud de Confiance , puoi eseguire i seguenti tipi di caricamento:
- Caricamenti con una sola richiesta, con caricamenti ripristinabili gestiti automaticamente per tuo conto
Riga di comando
Quando utilizzi Google Cloud CLI, puoi eseguire i seguenti tipi di caricamento:
- Caricamenti con una sola richiesta, con caricamenti ripristinabili gestiti automaticamente per tuo conto
- Caricamenti di streaming
- Caricamenti compositi paralleli
Librerie client
C++
Quando utilizzi la libreria client C++, puoi eseguire i seguenti tipi di caricamento:
C#
Quando utilizzi la libreria client C#, puoi eseguire i seguenti tipi di caricamento:
Go
Quando utilizzi la libreria client Go, puoi eseguire i seguenti tipi di caricamento:
- Caricamenti a richiesta singola e ripristinabili, a seconda delle dimensioni del file
- Caricamenti di streaming
Java
Quando utilizzi la libreria client Java, puoi eseguire i seguenti tipi di caricamento:
Node.js
Quando utilizzi la libreria client Node.js, puoi eseguire i seguenti tipi di caricamento:
PHP
Quando utilizzi la libreria client PHP, puoi eseguire i seguenti tipi di caricamento:
Python
Quando utilizzi la libreria client Python, puoi eseguire i seguenti tipi di caricamento:
- Caricamenti a richiesta singola e ripristinabili, a seconda delle dimensioni del file
- Caricamenti in più parti dell'API XML
Ruby
Quando utilizzi la libreria client Ruby, puoi eseguire i seguenti tipi di caricamento:
Terraform
Quando utilizzi Terraform, puoi eseguire caricamenti con una sola richiesta. I caricamenti ripristinabili vengono eseguiti automaticamente quando il file caricato è più grande di 16 MiB.
API REST
API JSON
Quando utilizzi l'API JSON, puoi eseguire i seguenti tipi di caricamento:
API XML
Quando utilizzi l'API XML, puoi eseguire i seguenti tipi di caricamento:
Se utilizzi le API REST per caricare oggetti, consulta Endpoint di richiesta per una discussione completa sugli endpoint di richiesta che puoi utilizzare.