Caricamenti e download

Questa pagina illustra i concetti relativi al caricamento e al download di oggetti. Puoi caricare e archiviare qualsiasi tipo MIME di dati fino a 5 TiB di dimensioni.

Caricamenti

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, tuttavia, 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 a richiesta singola anziché un caricamento ripristinabile o un caricamento multiparte dell'API XML, considera il 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 carichi 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.

Download

Tutti i download da Cloud Storage hanno lo stesso comportamento di base: una richiesta HTTP o HTTPS GET che può includere un'intestazione Range facoltativa, che definisce una parte specifica dell'oggetto da scaricare.

Utilizzando questo comportamento di download di base, puoi riprendere i download interrotti e puoi utilizzare strategie di download più avanzate, come i download di oggetti suddivisi e i download in streaming.

Supporto per strumento

Console

Quando utilizzi la consoleGoogle Cloud , puoi eseguire i seguenti tipi di caricamento e download:

Riga di comando

Quando utilizzi Google Cloud CLI, puoi eseguire i seguenti tipi di caricamenti e download:

Librerie client

C++

Quando utilizzi la libreria client C++, puoi eseguire i seguenti tipi di caricamenti e download:

C#

Quando utilizzi la libreria client C#, puoi eseguire i seguenti tipi di caricamenti e download:

Vai

Quando utilizzi la libreria client Go, puoi eseguire i seguenti tipi di caricamenti e download:

Java

Quando utilizzi la libreria client Java, puoi eseguire i seguenti tipi di caricamenti e download:

Node.js

Quando utilizzi la libreria client Node.js, puoi eseguire i seguenti tipi di caricamenti e download:

PHP

Quando utilizzi la libreria client PHP, puoi eseguire i seguenti tipi di caricamenti e download:

Python

Quando utilizzi la libreria client Python, puoi eseguire i seguenti tipi di caricamenti e download:

Ruby

Quando utilizzi la libreria client Ruby, puoi eseguire i seguenti tipi di caricamento e download:

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 caricamenti e download:

API XML

Quando utilizzi l'API XML, puoi eseguire i seguenti tipi di caricamenti e download:

Se utilizzi le API REST per il caricamento e il download, consulta la sezione Endpoint di richiesta per una discussione completa sugli endpoint di richiesta che puoi utilizzare.

Passaggi successivi