Obtenir la structure de stockage d'un bucket

Cette page explique comment déterminer la structure de stockage de votre bucket. La structure de stockage désigne la façon dont les objets sont organisés dans un bucket, soit dans un espace de noms unique, soit dans un espace de noms hiérarchique. Pour les applications qui interagissent avec le bucket, la structure revêt une importance particulière car les méthodes d'accès et de manipulation des objets varient en fonction d'elle. La structure de stockage inclut également des informations sur l'emplacement du bucket.

En utilisant l'API getStorageLayout, votre application peut adapter son comportement selon qu'un bucket utilise ou non un espace de noms hiérarchique. Cela garantit une compatibilité optimale et permet d'exploiter les fonctionnalités appropriées en fonction de la configuration du bucket.

Obtenir la structure de stockage d'un bucket

Ligne de commande

Exécutez la commande gcloud alpha storage buckets describe avec le flag --format :

gcloud alpha storage buckets describe gs://BUCKET_NAME --raw --format="default(hierarchicalNamespace)"

Où :

  • BUCKET_NAME est le nom du bucket concerné. Exemple : my-bucket.

Si l'opération réussit et que l'espace de noms hiérarchique est activé, la réponse se présente comme suit :

  hierarchicalNamespace:
    enabled: true

API JSON

  1. Vous devez installer et initialiser la gcloud CLI afin de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API JSON avec une requête getStorageLayout :

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/storageLayout"

    Où BUCKET_NAME est le nom du bucket concerné. Par exemple, my-bucket.

    Si l'opération réussit, la réponse se présente comme suit :

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

Étapes suivantes