Questa pagina mostra come leggere i dati degli oggetti dai bucket Cloud Storage direttamente nella memoria dell'applicazione o in modo interattivo nel browser web o nel terminale della riga di comando. La lettura di oggetti in memoria o in modo interattivo è consigliata quando vuoi trasmettere, ispezionare o elaborare i dati in modo da evitare il sovraccarico di CPU, I/O del disco e latenza associato alla scrittura di file in un file system locale persistente.
Per istruzioni sul download degli oggetti nello spazio di archiviazione permanente o locale, vedi Scarica gli oggetti. Per una panoramica concettuale delle letture e dei download degli oggetti, vedi Letture e download degli oggetti.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per leggere i dati degli oggetti, chiedi all'amministratore di concederti i seguenti ruoli IAM:
- Visualizzatore oggetti Storage (
roles/storage.objectViewer) sul bucket - Amministratore Storage (
roles/storage.admin) sul progetto (obbligatorio solo per la lettura dei dati degli oggetti utilizzando la console Cloud de Confiance )
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Il ruolo Visualizzatore oggetti Storage (roles/storage.objectViewer) contiene l'autorizzazione
storage.objects.get, necessaria per la lettura degli oggetti. Il ruolo
Amministratore Storage (roles/storage.admin) contiene le autorizzazioni storage.buckets.list
e storage.buckets.get, oltre all'autorizzazione storage.objects.get. Queste autorizzazioni sono necessarie per elencare i bucket di un progetto
e visualizzare le informazioni sui bucket. Il ruolo Storage Admin (roles/storage.admin) che include queste autorizzazioni è necessario solo quando vuoi leggere gli oggetti in modo interattivo utilizzando la console Cloud de Confiance .
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Per istruzioni sulla concessione dei ruoli sui bucket, consulta Impostare e gestire le policy IAM sui bucket.
Leggere gli oggetti in modo programmatico in memoria
Questa sezione descrive come leggere i dati degli oggetti trasmettendo in streaming i byte degli oggetti direttamente nella memoria dell'applicazione.
Librerie client
C++
Per saperne di più, 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 Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
C#
Per saperne di più, 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 Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Go
Per saperne di più, 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 Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per saperne di più, 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 Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Node.js
Per saperne di più, 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 Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
PHP
Per saperne di più, 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 Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Python
Per saperne di più, 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 Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Ruby
Per saperne di più, 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 Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Rust
Leggere gli oggetti in modo interattivo
Questa sezione descrive come leggere gli oggetti in modo interattivo nella finestra del browser della consoleCloud de Confiance o nel terminale della riga di comando stdout.
Console
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket di cui vuoi visualizzare i contenuti.
Nella scheda Oggetti, fai clic sul nome dell'oggetto che vuoi leggere.
Nella pagina Dettagli oggetto, fai clic sull'URL pubblico o sull'URL di autenticazione dell'oggetto per leggere i relativi dati.
Riga di comando
Per trasmettere in streaming il payload di byte di un oggetto direttamente nel terminale stdout,
utilizza il comando gcloud storage cat:
gcloud storage cat gs://BUCKET_NAME/OBJECT_NAME
Sostituisci quanto segue:
BUCKET_NAME: il nome del bucket che contiene l'oggetto che vuoi leggere. Ad esempio,my-bucket.OBJECT_NAME: il nome dell'oggetto che vuoi leggere. Ad esempio,dog.png.
API REST
Per leggere i byte di un oggetto e indirizzare il flusso di output al terminale
stdout, segui queste istruzioni.
API JSON
Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione
Authorization.Utilizza
cURLper chiamare l'API JSON con una richiestaobjects.getche includa l'opzione-o -e il parametro di queryalt=media:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o - \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Sostituisci quanto segue:
BUCKET_NAME: il nome del bucket che contiene l'oggetto che vuoi leggere. Ad esempio,my-bucket.OBJECT_NAME: il nome codificato tramite URL dell'oggetto che vuoi leggere. Ad esempio,pets/dog.png, codificato come URLpets%2Fdog.png.
API XML
Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione
Authorization.Utilizza
cURLper chiamare l'API XML con una richiestaGETObject:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME"
Sostituisci quanto segue:
BUCKET_NAME: il nome del bucket contenente l'oggetto che vuoi leggere. Ad esempio,my-bucket.OBJECT_NAME: il nome codificato tramite URL dell'oggetto che vuoi leggere. Ad esempio,pets/dog.png, codificato come URLpets%2Fdog.png.