Caricamenti e download

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

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 per intero in caso di mancata connessione. Consulta Caricare un oggetto da un file o Caricare un oggetto dalla memoria per le guide ai caricamenti con una singola richiesta.

  • Caricamento ripristinabile. Un metodo di caricamento che offre un trasferimento più affidabile, il che è particolarmente importante per i file di grandi dimensioni. I caricamenti riavviabili sono una buona scelta per la maggior parte delle applicazioni, poiché funzionano anche per i file di piccole dimensioni al costo di un'ulteriore richiesta HTTP per caricamento. Puoi anche utilizzare i caricamenti riavviabili per eseguire trasferimenti in streaming, il che ti consente di caricare un oggetto di dimensioni sconosciute.

  • Caricamento suddiviso in più parti dell'API XML. Un metodo di caricamento compatibile con i caricamenti suddivisi di Amazon S3. I file vengono caricati in parti e assemblati in un unico oggetto con la richiesta finale. I caricamenti multiparte dell'API XML ti consentono di caricare le parti in parallelo, riducendo potenzialmente il tempo necessario per completare il caricamento complessivo.

Con questi tipi di caricamento di base, sono possibili strategie di caricamento più avanzate:

  • Caricamento composito parallelo. Una strategia di caricamento in cui suddividi un file in blocchi 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 in streaming. Un metodo di caricamento che consente di caricare i dati senza doverli prima salvare in un file. È utile quando non conosci le dimensioni totali del caricamento all'inizio del caricamento.

  • Caricamento con codifica di trasferimento a blocchi. Un caricamento con una singola richiesta che include l'intestazione Transfer-Encoding: chunked, che consente di inviare il caricamento in più blocchi di dati sequenziali.

Considerazioni sulle dimensioni di caricamento

Quando scegli se utilizzare un caricamento con una singola richiesta anziché un caricamento ripristinabile o un caricamento multiparte dell'API XML, valuta il tempo che sei disposto a perdere in caso di errore di rete e devi riavviare il caricamento dall'inizio. Per connessioni più veloci, la dimensione massima può essere tipicamente maggiore.

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 singola richiesta per file di dimensioni fino a 30 MB.

  • Se esegui il caricamento da un servizio all'interno della regione con una velocità di caricamento media di 500 Mbps, la dimensione massima per i file è di quasi 2 GB.

Download

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

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

Assistenza per strumento

Console

Quando utilizzi la console Google Cloud, puoi eseguire i seguenti tipi di caricamenti 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 caricamenti e download:

Terraform

Quando utilizzi Terraform, puoi eseguire caricamenti con una singola richiesta. I caricamenti riavviabili vengono eseguiti automaticamente quando il file caricato è superiore a 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 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