Questa pagina mostra come ottenere informazioni sui metadati dei bucket di Cloud Storage, esclusi gli ACL e i criteri IAM.
Per informazioni su come ottenere il criterio IAM del tuo bucket, consulta Visualizzare il criterio IAM per un bucket.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per recuperare i metadati di un bucket Cloud Storage, chiedi all'amministratore di concederti il ruolo Amministratore Storage (roles/storage.admin
) per il bucket.
Questo ruolo contiene le autorizzazioni necessarie per ottenere i metadati di un bucket. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.list
- Questa autorizzazione è necessaria solo se prevedi di utilizzare la console Google Cloud per eseguire l'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.
Visualizza i metadati di un bucket
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket di cui vuoi visualizzare i metadati.
Fai clic sulla scheda Configurazione per visualizzare i dettagli del bucket, come le regioni incluse, la classe di archiviazione, le autorizzazioni e il tipo di replica.
Riga di comando
Utilizza il comando gcloud storage buckets describe
:
gcloud storage buckets describe gs://BUCKET_NAME
Dove:
BUCKET_NAME
è il nome del bucket di cui vuoi visualizzare i metadati. Ad esempio,my-awesome-bucket
.
In caso di esito positivo, la risposta sarà simile al seguente esempio:
defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...
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.
Terraform
Puoi utilizzare una risorsa Terraform per visualizzare i metadati di un bucket.
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
bucket:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.Se vuoi, puoi restringere i risultati dei metadati utilizzando il parametro della stringa di query
fields
. Ad esempio:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=FIELD1%2CFIELD2"
Dove
FIELD#
è una proprietà del bucket che vuoi includere nel risultato. Ad esempio,projectNumber
estorageClass
.
La risposta è simile al seguente esempio:
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
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 richiesta bucketGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?QUERY_PARAMETER"
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.QUERY_PARAMETER
è il campo dei metadati che vuoi restituire. Ad esempio,storageClass
per recuperare la classe di archiviazione del bucket. Con l'API XML puoi usare un solo parametro di query alla volta. Per un elenco dei campi di metadati supportati dall'API XML, consulta la pagina di riferimento del bucketGET
.
La risposta è simile al seguente esempio:
<StorageClass>STANDARD</StorageClass>
.
Passaggi successivi
- Leggi la panoramica dei metadati dei bucket.
- Elenca gli oggetti presenti nel bucket.
- Ottieni le dimensioni del bucket.
- Recupera i metadati degli oggetti.
- Modifica la classe di archiviazione predefinita per il bucket.
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