Recupera il layout dello spazio 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 le applicazioni che interagiscono con il bucket, poiché i metodi di accesso e manipolazione degli oggetti variano a seconda del layout. Il layout dello spazio di archiviazione include anche informazioni sulla posizione del bucket.

Utilizzando l'API getStorageLayout, la tua applicazione può adattare il suo comportamento in base al fatto che un bucket utilizzi o meno lo spazio dei nomi gerarchico, garantendo una compatibilità ottimale e sfruttando le funzionalità appropriate in base alla 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 anche ottenere questa autorizzazione 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.

Ottenere il layout dello spazio 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 è attivato, la risposta è simile all'esempio seguente:

  hierarchicalNamespace:
    enabled: true

API JSON

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

Prova Cloud Storage gratuitamente