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 tuo bucket. Il layout dello spazio 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 agli oggetti e di manipolazione variano a seconda del layout. Il layout di archiviazione include anche informazioni sulla località del bucket.

Utilizzando l'API getStorageLayout, l'applicazione può adattare il proprio comportamento a seconda 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 obbligatori

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

Il ruolo contiene l'autorizzazione storage.objects.list, necessaria per ottenere il layout 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, vedi Ruoli IAM per Cloud Storage.

Per istruzioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.

Ottieni il layout di archiviazione di un bucket

API JSON

1. Installa e inizializzatogcloud CLI per generare un token di accesso per l'intestazione Authorization.

   In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'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'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