Questa pagina mostra come ottenere informazioni sui metadati dei tuoi bucket Cloud Storage, escluse le policy IAM e gli ACL.
Per scoprire come ottenere il criterio IAM del tuo bucket, consulta la sezione 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
) nel bucket.
Questo ruolo contiene le autorizzazioni necessarie per ottenere i metadati di un bucket. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
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 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.
Visualizzare i metadati di un bucket
Console
- Nella console Google Cloud , vai alla pagina Bucket in 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, ad esempio 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
.
Se l'operazione ha esito positivo, la risposta è 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 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.
Terraform
Puoi utilizzare una risorsa Terraform per visualizzare i metadati di un bucket.
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 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
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 richiestaGET
Bucket: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 ottenere la classe di archiviazione del bucket. Puoi utilizzare un solo parametro di query alla volta con l'API XML. Per un elenco dei campi dei 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 del bucket.
- Elenca gli oggetti nel bucket.
- Ottieni le dimensioni del bucket.
- Recuperare i metadati dell'oggetto.
- 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 senza addebiti per l'esecuzione, il test e il deployment dei workload.
Prova Cloud Storage gratuitamente