Recupera il layout dello spazio di archiviazione di un bucket

In questa pagina viene descritto 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 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 di archiviazione include anche informazioni sulla località del bucket.

Utilizzando l'API getStorageLayout, la tua applicazione può adattare il suo comportamento in base all'utilizzo o meno dello spazio dei nomi gerarchico da parte di un bucket, garantendo una compatibilità ottimale e sfruttando le funzionalità appropriate in base alla configurazione del bucket.

Ottieni il layout di archiviazione di un bucket

Riga di comando

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

gcloud 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 al seguente esempio:

  hierarchicalNamespace:
    enabled: true

API JSON

  1. Avere gcloud CLI installata e inizializzata, che ti 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.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 al seguente esempio:

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

Passaggi successivi