Questa pagina mostra come scaricare oggetti dai bucket in Cloud Storage all'archiviazione permanente. Puoi anche scaricare 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 console Google Cloud, chiedi all'amministratore di concederti il ruolo Amministratore Storage (roles/storage.admin
) per il bucket.
Questi ruoli contengono le autorizzazioni necessarie per scaricare gli oggetti. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
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 essere in grado di ottenere queste autorizzazioni anche con altri ruoli predefiniti o ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli nei 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.
Viene visualizzata la pagina Dettagli bucket con la scheda Oggetti selezionata.
Vai all'oggetto, che potrebbe trovarsi in una cartella.
Fai clic sull'icona Scarica 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 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 che contiene 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 sarà 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 era stato interrotto.
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente scarica un singolo oggetto:
Nell'esempio seguente vengono scaricati più oggetti utilizzando più processi:
L'esempio seguente scarica tutti gli oggetti con un prefisso comune utilizzando più processi:
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente scarica un singolo oggetto:
Nell'esempio seguente vengono scaricati più oggetti utilizzando più processi:
Il seguente esempio scarica tutti gli oggetti in un bucket utilizzando più processi:
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper 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 richiestaGET
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 che contiene 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 URL comepets%2Fdog.png
.
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper 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 richiestaGET
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 che contiene 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 URL comepets%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.
scarica una parte di un oggetto
Se il download viene interrotto, puoi riprendere da dove avevi interrotto richiedendo solo la parte dell'oggetto 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, eccetto durante l'esecuzione di download in flussi. Se il download viene interrotto, un file temporaneo scaricato parzialmente diventa visibile nella gerarchia di destinazione. 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 sono 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 sono 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 C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in 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.
Assicurati che gcloud CLI sia installato e inizializzatoper 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 richiestaGET
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 che contiene 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 URL comepets%2Fdog.png
.
API XML
Utilizza l'intestazione Range
nella richiesta per scaricare una parte di
un oggetto.
Assicurati che gcloud CLI sia installato e inizializzatoper 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 richiestaGET
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 che contiene 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 URL comepets%2Fdog.png
.
Passaggi successivi
- Leggi la panoramica concettuale del caricamento e del download, incluse le strategie avanzate per il download.
- Trasferire dati da provider cloud o altre origini online, come elenchi di URL.
- Trasferisci gli oggetti all'istanza Compute Engine.
- Scopri come fatturare gli addebiti per l'accesso a Cloud Storage ai richiedenti.
- Scopri come Cloud Storage può pubblicare file gzip in 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 gratis