Alcune o tutte le informazioni in questa pagina potrebbero non essere applicabili a Cloud de Confiance di S3NS. Per maggiori dettagli, consulta Differenze rispetto a Google Cloud.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Recupera il layout dello spazio di archiviazione di un bucket

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 proprio 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) nel 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 nei 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

Assicurati che gcloud CLI sia installato e inizializzato, in modo da poter generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'API JSON con una richiesta getStorageLayout:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.s3nsapis.fr/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},
  }