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 con dimensioni 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 è sufficientemente piccolo da poter essere caricato interamente in caso di problemi di connessione. Consulta Caricamento di oggetti da file o Caricare l'oggetto dalla memoria per le guide ai caricamenti di richieste singole.

  • Carica l'oggetto dalla memoria: Un metodo di caricamento di un oggetto dalla memoria invece che da un file system.

  • Caricamento ripristinabile. È un metodo di caricamento che offre un trasferimento più affidabile, aspetto particolarmente importante per i file di grandi dimensioni. I caricamenti ripristinabili sono una buona scelta per la maggior parte delle applicazioni, poiché 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, che ti consentono di caricare un oggetto di dimensioni sconosciute.

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

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

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

  • Caricamento di flussi di dati. 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.

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 la quantità di tempo che vuoi perdere in caso di errore di rete e devi riavviare il caricamento dall'inizio. Per connessioni più veloci, in genere la dimensione di taglio può essere superiore.

Ad esempio, supponi di essere 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 caricamenti a richiesta singola per file di dimensioni fino a 30 MB.

  • Se carichi da un servizio locale che ha una velocità di caricamento media di 500 Mbps, 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 puoi utilizzare strategie di download più avanzate, come i download di oggetti a fette e i download in streaming.

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 di Ruby, puoi eseguire i seguenti tipi di caricamento e download:

Terraform

Quando utilizzi Terraform, puoi eseguire caricamenti di richieste singole. I caricamenti ripristinabili vengono eseguiti automaticamente quando il file caricato ha dimensioni superiori 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 Endpoint delle richieste per una discussione completa sugli endpoint delle richieste che puoi utilizzare.

Passaggi successivi