Caricamenti e download

Questa pagina descrive 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, 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 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 del caricamento.

  • 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 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.

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

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

Passaggi successivi