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 disposition du stockage de votre bucket. La mise en page du stockage fait référence à la façon dont les objets sont organisés dans un bucket, soit dans un espace de noms plat, soit dans 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 du 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.

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 accorder le rôle Utilisateur d'objets Storage (roles/storage.objectUser) sur le bucket.

Ce rôle contient l'autorisation storage.objects.list, qui est requise pour obtenir la mise en page du 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 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 ressemble à l'exemple suivant :

  hierarchicalNamespace:
    enabled: true

API JSON

Vous devez installer et initialiser gcloud CLI afin 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},
  }

Étapes suivantes

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