Cette page explique comment afficher la liste des buckets Cloud Storage d'un projet, classés alphabétiquement par nom.
Avant de commencer
Pour obtenir les autorisations nécessaires pour répertorier des buckets, demandez à votre administrateur de vous attribuer le rôle IAM "Administrateur de l'espace de stockage" (roles/storage.admin
) ou le rôle de base "Lecteur" (roles/viewer
) sur le projet contenant les buckets dont vous voulez afficher la liste.
Pour en savoir plus sur l'attribution de rôles aux projets, consultez la page Gérer l'accès aux projets.
Les rôles contiennent l'autorisation storage.buckets.list
, qui est nécessaire pour répertorier les buckets. Vous pouvez également obtenir cette autorisation avec des rôles personnalisés.
Répertorier les buckets d'un projet
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Les buckets faisant partie du projet actuellement sélectionné apparaissent dans la liste.
Vous pouvez éventuellement utiliser le filtrage et le tri pour limiter et organiser les résultats dans votre liste.
Ligne de commande
-
Dans la console Google Cloud, activez Cloud Shell.
En bas de la fenêtre de la console Google Cloud, une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.
Dans votre environnement de développement, exécutez la commande
gcloud storage ls
:gcloud storage ls
La réponse est semblable à ceci :
gs://BUCKET_NAME1/ gs://BUCKET_NAME2/ gs://BUCKET_NAME3/ ...
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
API REST
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
.Vous pouvez également créer un jeton d'accès à l'aide d'OAuth 2.0 Playground et l'inclure dans l'en-tête
Authorization
.Utilisez
cURL
pour appeler l'API JSON avec une requête permettant de répertorier les buckets :curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER"
Où
PROJECT_IDENTIFIER
est l'ID ou le numéro du projet contenant les buckets dont vous voulez afficher la liste. Exemple :my-project
.
API XML
Vous devez installer et initialiser gcloud CLI afin de générer un jeton d'accès pour l'en-tête
Authorization
.Vous pouvez également créer un jeton d'accès à l'aide d'OAuth 2.0 Playground et l'inclure dans l'en-tête
Authorization
.Utilisez
cURL
pour appeler l'API XML avec une requêteGET
Service :curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com"
Où
PROJECT_ID
est l'ID du projet contenant les buckets dont vous voulez afficher la liste. Exemple :my-project
Étapes suivantes
- Obtenez des informations sur la taille d'un bucket.
- Répertoriez les objets d'un bucket.
- Déplacez ou renommez un bucket.
- Supprimez un bucket.
- Découvrez comment paginer les résultats.