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
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
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.