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.

Video caricati

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 poter essere caricato nella sua interezza in caso di interruzione della connessione. Consulta Carica l'oggetto dal file o Carica l'oggetto dalla memoria per le guide ai caricamenti per richieste singole.

  • Carica l'oggetto dalla memoria. Un metodo di caricamento in cui un oggetto viene caricato dalla memoria anziché da un file system.

  • Caricamento ripristinabile. Un metodo di caricamento che offra un trasferimento più affidabile, particolarmente importante con file di grandi dimensioni. I caricamenti ripristinabili sono una buona scelta per la maggior parte delle applicazioni, dato che funzionano anche per file di piccole dimensioni al costo di una richiesta HTTP aggiuntiva per caricamento. Puoi anche utilizzare caricamenti ripristinabili per eseguire trasferimenti di flussi di dati, che ti consentono di caricare un oggetto di dimensioni sconosciute.

  • Caricamento multiparte dell'API XML. Un metodo di caricamento compatibile con i caricamenti multiparte 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 di completamento del caricamento complessivo.

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

  • Caricamento composito parallelo: Una strategia di caricamento prevede la suddivisione di un file in blocchi e il caricamento in parallelo. A differenza dei caricamenti multiparte dell'API XML, i caricamenti compositi paralleli utilizzano l'operazione di scrittura e l'oggetto finale viene archiviato come oggetto composito.

  • Caricamento di streaming. Un metodo di caricamento che consente di caricare i dati senza richiederne prima il salvataggio in un file. Questo è utile quando non conosci le dimensioni totali del caricamento all'inizio.

Considerazioni sulle dimensioni del caricamento

Quando scegli se utilizzare un caricamento di richiesta singola anziché un caricamento ripristinabile o un caricamento multiparte dell'API XML, considera la quantità di tempo che vuoi perdere in caso di errore di rete e dovrai riavviare il caricamento dall'inizio. Per connessioni più veloci, la dimensione limite può essere maggiore.

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

  • Se effettui un caricamento da un sistema locale con una velocità media di caricamento di 8 Mbps, puoi utilizzare la richiesta singola per i file di dimensioni pari a 30 MB.

  • Se esegui il caricamento da un servizio interno a una regione che ha una media di 500 Mbps per la sua velocità di 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.

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

Assistenza per strumento

Console

Quando utilizzi la console Google 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:

Go

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 di richieste singole. I caricamenti ripristinabili avvengono automaticamente quando il file in fase di caricamento supera i 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 Endpoint di richiesta per una discussione completa sugli endpoint delle richieste che puoi utilizzare.

Passaggi successivi