Recupera il layout dello spazio di archiviazione di un bucket

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina descrive 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 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 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 oggetti Storage (roles/storage.objectUser) sul bucket.

Il ruolo contiene l'autorizzazione storage.objects.list, necessaria per recuperare 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 su come concedere i ruoli sui bucket, consulta Utilizzare IAM con i bucket.

Recuperare il layout di archiviazione di un bucket

Riga di comando

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

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. Assicurati che gcloud CLI sia installato e inizializzato, in modo da poter 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 all'esempio seguente:

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

Passaggi successivi

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

Prova Cloud Storage senza costi