Questa pagina mostra come scaricare gli oggetti dai bucket in Cloud Storage nell'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
) per il bucket. Se prevedi di utilizzare la
consoleGoogle Cloud , chiedi all'amministratore di concederti il ruolo Amministratore archiviazione
(roles/storage.admin
) nel bucket.
Questi ruoli contengono le autorizzazioni necessarie per scaricare gli oggetti. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.list
- Questa autorizzazione è necessaria solo per utilizzare la console Google Cloud per eseguire le attività in questa pagina.
storage.objects.get
storage.objects.list
- Questa autorizzazione è necessaria solo per utilizzare la console Google Cloud per eseguire le attività in questa pagina.
Potresti anche ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.
Scaricare 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 in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene l'oggetto che vuoi scaricare.
Viene visualizzata la pagina Dettagli bucket, con la scheda Oggetti selezionata.
Vai all'oggetto, che potrebbe trovarsi in una cartella.
Fai clic sull'icona Download associata all'oggetto.
Le impostazioni del browser controllano la posizione di download dell'oggetto.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud , consulta Risoluzione dei problemi.
Riga di comando
Utilizza 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'operazione ha 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 dal punto in cui è stato interrotto.
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio scarica un singolo oggetto:
L'esempio seguente scarica più oggetti utilizzando più processi:
Il seguente esempio scarica tutti gli oggetti con un prefisso comune utilizzando più processi:
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio scarica un singolo oggetto:
L'esempio seguente scarica più oggetti utilizzando più processi:
Il seguente esempio scarica tutti gli oggetti con un prefisso comune utilizzando più processi:
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio scarica un singolo oggetto:
L'esempio seguente scarica più oggetti utilizzando più processi:
L'esempio seguente scarica tutti gli oggetti in un bucket utilizzando più processi:
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiesta diGET
oggetto: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
, codificato come URLpets%2Fdog.png
.
API XML
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta diGET
oggetto: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
, codificato come URLpets%2Fdog.png
.
Per scaricare in modo più efficiente tutti gli oggetti in un bucket o in una sottodirectory, utilizza il
comando gcloud storage cp
o una libreria client:
gcloud storage cp --recursive gs://BUCKET_NAME/FOLDER_NAME .
Scaricare una parte di un oggetto
Se il download viene interrotto, puoi riprendere da dove avevi interrotto richiedendo solo la parte dell'oggetto rimanente. 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 quando esegue download in streaming. Se il download viene
interrotto, un file temporaneo scaricato parzialmente diventa visibile
nella gerarchia della destinazione. Esegui lo stesso comando cp
per riprendere il
download da dove 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 maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Utilizza l'intestazione Range
nella richiesta per scaricare una parte di un oggetto.
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiesta diGET
oggetto: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
, codificato come URLpets%2Fdog.png
.
API XML
Utilizza l'intestazione Range
nella richiesta per scaricare una parte di un oggetto.
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta diGET
oggetto: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
, codificato come URLpets%2Fdog.png
.
Passaggi successivi
- Leggi la panoramica concettuale del caricamento e del download, incluse strategie di download avanzate.
- Trasferisci dati da cloud provider o altre origini online, ad esempio elenchi di URL.
- Trasferisci gli oggetti all'istanza Compute Engine.
- Scopri come puoi addebitare ai richiedenti i costi di accesso a Cloud Storage.
- Scopri come Cloud Storage può pubblicare file compressi con 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 senza addebiti per l'esecuzione, il test e il deployment dei workload.
Prova Cloud Storage gratuitamente