Questa pagina mostra come scaricare oggetti dai bucket in Cloud Storage allo spazio di archiviazione permanente. Puoi anche scaricare gli oggetti in memoria.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per scaricare gli oggetti, chiedi all'amministratore di concederti il ruolo Visualizzatore oggetti Storage (roles/storage.objectViewer
) nel bucket. Se prevedi di utilizzare la console Google Cloud, chiedi all'amministratore di concederti invece il ruolo Amministratore Storage (roles/storage.admin
) nel bucket.
Questi ruoli contengono le autorizzazioni necessarie per scaricare gli oggetti. Per visualizzare esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.list
- Questa autorizzazione è richiesta solo per utilizzare la console Google Cloud per eseguire le attività in questa pagina.
storage.objects.get
storage.objects.list
- Questa autorizzazione è richiesta solo per utilizzare la console Google Cloud per eseguire le attività in questa pagina.
Potresti anche riuscire a ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.
scarica un oggetto da un bucket
Completa le seguenti istruzioni per scaricare un oggetto da un bucket:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene l'oggetto da scaricare.
Si apre la pagina Dettagli bucket, con la scheda Oggetti selezionata.
Accedi all'oggetto, che potrebbe trovarsi in una cartella.
Fai clic sull'icona di download associata all'oggetto.
Le impostazioni del browser controllano il percorso di download dell'oggetto.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni Cloud Storage non riuscite nella console Google Cloud, consulta la pagina Risoluzione dei problemi.
Riga di comando
Usa il comando gcloud storage cp
:
gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION
Dove:
BUCKET_NAME
è il nome del bucket contenente l'oggetto che stai scaricando. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto che stai scaricando. Ad esempio,pets/dog.png
.SAVE_TO_LOCATION
è il percorso locale in cui salvi l'oggetto. Ad esempio,Desktop/Images
.
Se l'esito è positivo, la risposta è simile al seguente esempio:
Completed files 1/1 | 164.3kiB/164.3kiB
Se il download viene interrotto prima del completamento, esegui lo stesso comando cp
per riprendere il download da dove l'aveva interrotto.
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio scarica un singolo oggetto:
Nell'esempio seguente vengono scaricati più oggetti utilizzando più processi:
Nell'esempio seguente vengono scaricati tutti gli oggetti con un prefisso comune utilizzando più processi:
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio scarica un singolo oggetto:
Nell'esempio seguente vengono scaricati più oggetti utilizzando più processi:
Nell'esempio seguente vengono scaricati tutti gli oggetti con un prefisso comune utilizzando più processi:
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio scarica un singolo oggetto:
Nell'esempio seguente vengono scaricati più oggetti utilizzando più processi:
Nell'esempio seguente vengono scaricati tutti gli oggetti in un bucket utilizzando più processi:
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Installa e inizializzatogcloud CLI per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiesta OggettoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Dove:
SAVE_TO_LOCATION
è il percorso della posizione in cui vuoi salvare l'oggetto. Ad esempio,Desktop/dog.png
.BUCKET_NAME
è il nome del bucket contenente l'oggetto che stai scaricando. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto che stai scaricando. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
API XML
Installa e inizializzatogcloud CLI per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta OggettoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Dove:
SAVE_TO_LOCATION
è il percorso della posizione in cui vuoi salvare l'oggetto. Ad esempio,Desktop/dog.png
.BUCKET_NAME
è il nome del bucket contenente l'oggetto che stai scaricando. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto che stai scaricando. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
Per scaricare in modo più efficiente tutti gli oggetti in un bucket o una sottodirectory, utilizza il comando gcloud storage cp
o una libreria client.
Scaricare una parte di un oggetto
Se il download viene interrotto, puoi riprendere da dove avevi interrotto richiedendo solo la parte dell'oggetto che è rimasta. Completa le seguenti istruzioni per scaricare una parte di un oggetto.
Console
La console Google Cloud non supporta il download di parti di un oggetto. Utilizza invece gcloud CLI.
Riga di comando
Google Cloud CLI tenta automaticamente di riprendere i download interrotti,
tranne durante l'esecuzione di download in streaming. Se il download viene interrotto, nella gerarchia di destinazione diventa visibile un file temporaneo scaricato parzialmente. Esegui lo stesso comando cp
per riprendere il download dal punto in cui era stato interrotto.
Al termine del download, il file temporaneo viene eliminato e sostituito con i contenuti scaricati. I file temporanei vengono archiviati in una posizione configurabile, che per impostazione predefinita si trova nella home directory dell'utente in .config/gcloud/surface_data/storage/tracker_files
. Puoi modificare o visualizzare la posizione in cui vengono archiviati i file temporanei eseguendo gcloud config get storage/tracker_files_directory
.
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Utilizza l'intestazione Range
nella richiesta per scaricare una parte di
un oggetto.
Installa e inizializzatogcloud CLI per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiesta OggettoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Dove:
FIRST_BYTE
è il primo byte nell'intervallo di byte che vuoi scaricare. Ad esempio,1000
.LAST_BYTE
è l'ultimo byte nell'intervallo di byte che vuoi scaricare. Ad esempio,1999
.SAVE_TO_LOCATION
è il percorso della posizione in cui vuoi salvare l'oggetto. Ad esempio,Desktop/dog.png
.BUCKET_NAME
è il nome del bucket contenente l'oggetto che stai scaricando. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto che stai scaricando. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
API XML
Utilizza l'intestazione Range
nella richiesta per scaricare una parte di
un oggetto.
Installa e inizializzatogcloud CLI per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta OggettoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Dove:
FIRST_BYTE
è il primo byte nell'intervallo di byte che vuoi scaricare. Ad esempio,1000
.LAST_BYTE
è l'ultimo byte nell'intervallo di byte che vuoi scaricare. Ad esempio,1999
.SAVE_TO_LOCATION
è il percorso della posizione in cui vuoi salvare l'oggetto. Ad esempio,$HOME/Desktop/dog.png
.BUCKET_NAME
è il nome del bucket contenente l'oggetto che stai scaricando. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto che stai scaricando. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
Passaggi successivi
- Leggi la panoramica concettuale per il caricamento e il download, che include strategie di download avanzate.
- Trasferisci i dati da cloud provider o da altre origini online, ad esempio gli elenchi di URL.
- Trasferisci oggetti all'istanza Compute Engine.
- Scopri come fatturare i costi di accesso a Cloud Storage ai richiedenti.
- Scopri come Cloud Storage può pubblicare file compressi in formato gzip in uno stato non compresso.
Provalo
Se non conosci Google Cloud, crea un account per valutare le prestazioni di Cloud Storage in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Prova Cloud Storage gratuitamente