Recupera il layout dello spazio di archiviazione di un bucket

In questa pagina viene descritto come determinare il layout di archiviazione del bucket. Il layout di archiviazione si riferisce al modo in cui gli oggetti sono organizzati all'interno di un bucket, in uno spazio dei nomi semplice o in uno spazio dei nomi gerarchico. Il layout è importante per le applicazioni che interagiscono con il bucket, poiché i metodi di accesso e manipolazione degli oggetti variano a seconda del layout. Il layout di archiviazione include anche informazioni sulla località del bucket.

Utilizzando l'API getStorageLayout, la tua applicazione può adattare il suo comportamento in base all'utilizzo o meno dello spazio dei nomi gerarchico da parte di un bucket, garantendo una compatibilità ottimale e sfruttando le funzionalità appropriate in base alla configurazione del bucket.

Ruoli richiesti

Per ottenere le autorizzazioni necessarie per ottenere il layout di archiviazione di un bucket Cloud Storage , chiedi all'amministratore di concederti il ruolo Storage Object User (roles/storage.objectUser) sul bucket.

Il ruolo contiene l'autorizzazione storage.objects.list, necessaria per ottenere il layout di archiviazione del bucket.

Potresti anche ottenere questa autorizzazione con altri ruoli personalizzati o ruoli predefiniti. Per vedere quali ruoli sono associati a quali autorizzazioni, consulta Ruoli IAM per Cloud Storage.

Per istruzioni sulla concessione di ruoli sui bucket, consulta Utilizza IAM con i bucket.

Ottieni il layout di archiviazione di un bucket

Riga di comando

Utilizza il comando gcloud storage buckets describe con il flag --format:

gcloud storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"

Dove:

• BUCKET_NAME è il nome del bucket pertinente. Ad esempio, my-bucket.

Se l'operazione ha esito positivo e lo spazio dei nomi gerarchico è abilitato, la risposta è simile al seguente esempio:

  hierarchicalNamespace:
    enabled: true

API JSON

1. Avere gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione Authorization.

2. Utilizza cURL per chiamare l'API JSON con una richiesta getStorageLayout:

   curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/storageLayout"

   Dove BUCKET_NAME è il nome del bucket pertinente. Ad esempio, my-bucket.

   Se l'operazione ha esito positivo, la risposta è simile al seguente esempio:

     {
         "kind": "storage#storageLayout",
         "bucket": "my-bucket",
         "location": "us-central1",
         "locationType": "region",
         "hierarchicalNamespace":{enabled: true},
     }

Passaggi successivi

• Informazioni sulle cartelle.
• Crea e gestisci le cartelle.
• Rinominare le cartelle.

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 costi per l'esecuzione, il test e il deployment dei workload.

Prova Cloud Storage senza costi aggiuntivi