Cette page a été traduite par l'API Cloud Translation.

Obtenir la structure de l'espace de stockage d'un bucket

Cette page explique comment déterminer la mise en page de stockage de votre bucket. La mise en page de stockage fait référence à la façon dont les objets sont organisés dans un bucket, que ce soit dans un espace de noms plat ou un espace de noms hiérarchique. La mise en page est importante pour les applications qui interagissent avec le bucket, car les méthodes d'accès et de manipulation des objets varient en fonction de la mise en page. La mise en page de l'espace de stockage inclut également des informations sur l'emplacement du bucket.

En utilisant l'API getStorageLayout, votre application peut adapter son comportement en fonction de l'utilisation ou non d'un espace de noms hiérarchique par un bucket, ce qui garantit une compatibilité optimale et exploite les fonctionnalités appropriées en fonction de la configuration du bucket.

Rôles requis

Pour obtenir les autorisations requises pour obtenir la mise en page de stockage d'un bucket Cloud Storage , demandez à votre administrateur de vous attribuer le rôle "Utilisateur d'objets Storage" (roles/storage.objectUser) sur le bucket.

Le rôle contient l'autorisation storage.objects.list, qui est requise pour obtenir la mise en page de stockage du bucket.

Vous pouvez également obtenir cette autorisation avec d'autres rôles personnalisés ou rôles prédéfinis. Pour connaître les rôles et les autorisations associées, consultez la page Rôles IAM pour Cloud Storage.

Pour savoir comment attribuer des rôles aux buckets, consultez la section Utiliser IAM avec des buckets.

Obtenir la structure de l'espace de stockage d'un bucket

Ligne de commande

Exécutez la commande gcloud alpha storage buckets describe avec l'option --format :

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

Où :

BUCKET_NAME correspond au 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

Vous devez installer et initialiser gcloud CLI , ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

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.googleapis.com/storage/v1/b/BUCKET_NAME/storageLayout"

Où BUCKET_NAME est le nom du bucket concerné. 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},
  }

Étape suivante

Faites l'essai

Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de Cloud Storage en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

Profiter d'un essai gratuit de Cloud Storage