Questa pagina mostra come ottenere informazioni sui metadati dei tuoi I bucket di Cloud Storage, esclusi ACL e criteri IAM.
Per scoprire come ottenere il criterio IAM del tuo bucket, consulta Visualizza il criterio IAM per un bucket.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per recuperare i metadati di un
per il bucket Cloud Storage, chiedi all'amministratore di concederti lo spazio di archiviazione
Ruolo Amministratore (roles/storage.admin
) per il bucket.
Questo ruolo contiene le autorizzazioni necessarie per ottenere i metadati di un bucket. Per vedere con esattezza le autorizzazioni necessarie, espandi la sezione Sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.list
- Questa autorizzazione è necessaria solo se prevedi di utilizzare nella console Google Cloud per eseguire l'attività in questa pagina.
Potresti riuscire a 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 i metadati da visualizzare.
Fai clic sulla scheda Configurazione per visualizzare i dettagli del bucket come inclusi regioni, classe di archiviazione, autorizzazioni e 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'esito è positivo, la risposta è simile al seguente esempio:
defaultEventBasedHold: false etag: CAE= iamConfiguration: bucketPolicyOnly: enabled: true ...
Librerie client
C++
Per ulteriori informazioni, consulta API Cloud Storage C++ documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta API Cloud Storage Ruby documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Terraform
Puoi utilizzare una risorsa Terraform per visualizzare metadati.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo 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 del bucket pertinente. Ad esempio,my-bucket
.Facoltativamente, puoi restringere i risultati dei metadati utilizzando il metodo 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 da includere nel risultato. Ad esempio,projectNumber
estorageClass
.
La risposta è simile al seguente esempio:
{ "projectNumber": "123456789012", "storageClass": "STANDARD" }
API XML
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con un 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 di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.QUERY_PARAMETER
è il campo di metadati che che vuoi restituire. Ad esempio,storageClass
per ottenere di archiviazione del bucket. Puoi utilizzare un solo parametro di query per con l'API XML. Per un elenco dei campi dei metadati supportati l'API XML, consulta la pagina di riferimento del bucketGET
.
La risposta è simile al seguente esempio:
<StorageClass>STANDARD</StorageClass>
.
Passaggi successivi
- Leggi la panoramica sui metadati dei bucket.
- Elenca gli oggetti nel bucket.
- Determina 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