Caricamenti e download

In questa pagina vengono illustrati 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 di una richiesta singola. Un metodo di caricamento in cui un oggetto viene caricato come una singola richiesta. Utilizza questa opzione se il file è abbastanza piccolo da essere caricato per intero in caso di mancata connessione. Consulta: Carica l'oggetto dal file o Carica l'oggetto dalla memoria per le guide caricamenti di richieste singole.

  • Caricamento ripristinabile. Un metodo di caricamento che offre un'esperienza trasferimento, cosa particolarmente importante per i file di grandi dimensioni. Caricamenti ripristinabili sono una buona scelta per la maggior parte delle applicazioni, in quanto funzionano anche per file di piccole dimensioni al costo di una richiesta HTTP aggiuntiva per caricamento. Puoi anche utilizzare di caricamenti ripristinabili per eseguire trasferimenti di flussi di dati, che ti consentono di caricare un oggetto di dimensioni sconosciute.

  • Caricamento suddiviso in più parti dell'API XML. Un metodo di caricamento compatibile con Caricamenti multiparte 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 consentono di caricare le parti in parallelo, riducendo potenzialmente il tempo di completamento il caricamento complessivo.

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

  • Caricamento composito parallelo. Una strategia di caricamento che prevede la suddivisione di un e carica 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 di flussi di dati. 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. tramite un caricamento di una singola richiesta include l'intestazione Transfer-Encoding: chunked, consentendo il caricamento inviati in più blocchi sequenziali di dati.

Considerazioni sulle dimensioni del caricamento

Quando scegli se utilizzare un caricamento di richiesta singola anziché un caricamento ripristinabile caricamento o caricamento multiparte dell'API XML, considera la quantità di tempo che che è disposto a perdere nel caso si verifichi un errore di rete ed è necessario riavviare per il caricamento dall'inizio. Per connessioni più veloci, la dimensione limite può in genere sono più grandi.

Ad esempio, supponiamo che tu sia disposto a tollerare 30 secondi di tempo perso:

  • Se carichi da un sistema locale con una velocità media di caricamento di 8 Mbps, puoi utilizzare caricamenti di richieste singole per file di dimensioni pari a 30 MB.

  • Se esegui il caricamento da un servizio interno a una regione con una media di 500 Mbps per il caricamento la dimensione limite 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 il comando , puoi eseguire i seguenti tipi di caricamenti e download Libreria client PHP:

Python

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

Ruby

Quando utilizzi il comando , puoi eseguire i seguenti tipi di caricamento e download Libreria client Ruby:

Terraform

Quando utilizzi Terraform, puoi eseguire caricamenti di richieste singole. I caricamenti ripristinabili si verificano automaticamente quando il file in fase di caricamento 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 le API REST per il caricamento e il download, consulta Richiedere endpoint per una discussione completa sugli endpoint delle richieste che puoi usare.

Passaggi successivi