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.

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

  1. 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.

  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.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