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. Archiviazione Il layout si riferisce al modo in cui gli oggetti sono organizzati all'interno di un bucket, in un o 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 informazioni sulla località 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 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, che è 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. Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione Authorization.

   In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo 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 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