Ottieni il layout di archiviazione di un bucket

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa pagina descrive come determinare il layout di archiviazione del bucket. Con layout di archiviazione si indica la modalità di organizzazione degli oggetti all'interno di un bucket, in uno spazio dei nomi piatto o in uno spazio dei nomi gerarchico. Il layout è importante per applicazioni che interagiscono con il bucket, per l'accesso e la manipolazione degli oggetti variano a seconda del layout. Il layout dello spazio di archiviazione include anche informazioni sulla posizione del bucket.

Se usi l'API getStorageLayout, la tua applicazione può adattare il comportamento degli utenti a seconda che un bucket utilizzi o meno uno spazio dei nomi gerarchico, assicurando la compatibilità ottimale e sfruttando le funzionalità appropriate in base configurazione del bucket.

Ruoli richiesti

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

Il ruolo contiene l'autorizzazione storage.objects.list, obbligatoria per recuperare il layout dello spazio di archiviazione del bucket.

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

Per istruzioni su come concedere i ruoli ai bucket, consulta Utilizzare IAM con i bucket.

Ottieni il layout di archiviazione di un bucket

Riga di comando

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

gcloud alpha 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 all'esempio seguente:

  hierarchicalNamespace:
    enabled: true

API JSON

1. Avere gcloud CLI installato e inizializzato, che consente generi 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.
• Creare e gestire 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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Prova Cloud Storage gratuitamente