Cette page montre comment ajouter, modifier, supprimer et afficher les libellés définis sur un bucket dans Cloud Storage.
Rôles requis
Pour obtenir les autorisations requises pour ajouter et gérer les libellés de bucket, demandez à votre administrateur de vous accorder le rôle IAM "Administrateur de l'espace de stockage" (roles/storage.admin
) sur le bucket.
Ce rôle prédéfini contient les autorisations requises pour ajouter et gérer des libellés de buckets. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
storage.buckets.get
storage.buckets.list
- Cette autorisation n'est nécessaire que si vous prévoyez d'utiliser la console Google Cloud pour suivre les instructions de cette page.
storage.buckets.update
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés.
Pour savoir comment attribuer des rôles aux buckets, consultez la section Utiliser IAM avec des buckets.
Ajouter, modifier ou supprimer les libellés d'un bucket
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket pour lequel vous souhaitez ajouter, modifier ou supprimer des libellés.
Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.
Cliquez sur l'icône Modifier (edit) pour Libellés.
La fenêtre de l'éditeur de libellés s'affiche.
Pour ajouter un libellé, cliquez sur le bouton add_box Ajouter un libellé, puis spécifiez une clé (
key
) et une valeur (value
) pour votre libellé.Pour modifier un libellé existant, cliquez sur sa valeur et saisissez une nouvelle valeur.
Pour supprimer un libellé, cliquez sur l'icône Corbeille associée au libellé à supprimer.
Cliquez sur Enregistrer.
Pour savoir comment obtenir des informations détaillées sur les erreurs liées aux opérations Cloud Storage ayant échoué dans la console Google Cloud, consultez la section Dépannage.
Ligne de commande
Pour ajouter un libellé ou mettre à jour un libellé existant, exécutez la commande gcloud storage buckets update
avec l'option --update-labels
. Exemple :
gcloud storage buckets update gs://BUCKET_NAME --update-labels=KEY_1=VALUE_1
Lieu
BUCKET_NAME
est le nom du bucket auquel le libellé s'applique. Par exemple,my-bucket
.KEY_1
est le nom de clé du libellé. Exemple :pet
.VALUE_1
est la valeur du libellé. Exemple :dog
.
Pour supprimer un libellé existant, utilisez l'option -remove-labels
. Exemple :
gcloud storage buckets update gs://BUCKET_NAME --remove-labels=KEY_1
Vous pouvez modifier plusieurs libellés à l'aide des commandes précédentes en incluant les libellés sous la forme d'une liste d'éléments séparés par une virgule dans l'option appropriée. Par exemple, --update-labels=blue-key=cyan,red-key=ruby
.
Pour supprimer tous les libellés associés à un bucket, utilisez la commande suivante :
gcloud storage buckets update gs://BUCKET_NAME --clear-labels
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.
L'exemple suivant ajoute le libellé spécifié à un bucket ou le modifie s'il existe déjà pour le bucket :
L'exemple suivant supprime le libellé spécifié d'un bucket :
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.
L'exemple suivant ajoute le libellé spécifié à un bucket ou le modifie s'il existe déjà pour le bucket :
L'exemple suivant supprime le libellé spécifié d'un bucket :
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.
L'exemple suivant ajoute le libellé spécifié à un bucket ou le modifie s'il existe déjà pour le bucket :
L'exemple suivant supprime le libellé spécifié d'un bucket :
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.
L'exemple suivant ajoute le libellé spécifié à un bucket ou le modifie s'il existe déjà pour le bucket :
L'exemple suivant supprime le libellé spécifié d'un bucket :
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.
L'exemple suivant ajoute le libellé spécifié à un bucket ou le modifie s'il existe déjà pour le bucket :
L'exemple suivant supprime le libellé spécifié d'un bucket :
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.
L'exemple suivant ajoute le libellé spécifié à un bucket ou le modifie s'il existe déjà pour le bucket :
L'exemple suivant supprime le libellé spécifié d'un bucket :
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.
L'exemple suivant ajoute le libellé spécifié à un bucket ou le modifie s'il existe déjà pour le bucket :
L'exemple suivant supprime le libellé spécifié d'un bucket :
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.
L'exemple suivant ajoute le libellé spécifié à un bucket ou le modifie s'il existe déjà pour le bucket :
L'exemple suivant supprime le libellé spécifié d'un bucket :
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
.Créez un fichier JSON contenant les informations suivantes :
{ "labels": { "KEY_1": "VALUE_1" } }
Lieu
KEY_1
est le nom de clé du libellé. Exemple :pet
.VALUE_1
est la valeur du libellé. Exemple :dog
. Si vous souhaitez supprimer une clé, utiliseznull
à la place de"<var>VALUE_1</var>"
.
Exécutez
cURL
pour appeler l'API JSON avec une requête de bucketPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=labels"
Où :
JSON_FILE_NAME
correspond au chemin d'accès au fichier JSON que vous avez créé à l'étape 2.BUCKET_NAME
est le nom du bucket auquel le libellé s'applique. Exemple :my-bucket
Vous pouvez ajouter, modifier ou supprimer plusieurs paires key:value
dans une requête.
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
.Créez un fichier XML contenant les informations suivantes :
<Tagging> <TagSet> <Tag> <Key>KEY_1</Key> <Value>VALUE_1</Value> </Tag> </TagSet> </Tagging>
Où :
KEY_1
est le nom de clé du libellé. Exemple :pet
.VALUE_1
est la valeur du libellé. Exemple :dog
.
Notez que vous pouvez ajouter plusieurs éléments
<Tag>
dans une requête. Si vous souhaitez supprimer tous les libellés d'un bucket, utilisez un seul élément<Tag>
vide dans le fichier :<Tagging> <TagSet> <Tag> </Tag> </TagSet> </Tagging>
Utilisez
cURL
pour appeler l'API XML avec une requêtePUT
Bucket et le paramètre de chaîne de requêtetagging
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
Où :
XML_FILE_NAME
correspond au chemin d'accès au fichier XML que vous avez créé à l'étape 2.BUCKET_NAME
est le nom du bucket auquel le libellé s'applique. Exemple :my-bucket
Afficher les libellés de buckets
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Cliquez sur le nom du bucket dont vous souhaitez vérifier les étiquettes.
Cliquez sur l'onglet Configuration.
Les étiquettes définies sur le bucket sont regroupées dans le champ Étiquettes.
Pour savoir comment obtenir des informations détaillées sur les erreurs liées aux opérations Cloud Storage ayant échoué dans la console Google Cloud, consultez la section Dépannage.
Ligne de commande
Exécutez la commande gcloud storage buckets describe
avec l'option --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(labels)"
Où BUCKET_NAME
correspond au nom du bucket dont vous souhaitez afficher les libellés. Par exemple, my-bucket
.
Si l'opération aboutit et que des libellés existent pour le bucket, la réponse se présente comme suit :
labels: red-key: ruby blue-key: cyan
Si l'opération réussit et qu'aucun libellé n'existe pour le bucket, la réponse se présente comme suit :
null
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.
Pour afficher les étiquettes d'un bucket, suivez les instructions permettant d'afficher les métadonnées d'un bucket et recherchez le champ de l'étiquette dans la réponse.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.
Pour afficher les étiquettes d'un bucket, suivez les instructions permettant d'afficher les métadonnées d'un bucket et recherchez le champ de l'étiquette dans la réponse.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.
Pour afficher les étiquettes d'un bucket, suivez les instructions permettant d'afficher les métadonnées d'un bucket et recherchez le champ de l'étiquette dans la réponse.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.
Pour afficher les étiquettes d'un bucket, suivez les instructions permettant d'afficher les métadonnées d'un bucket et recherchez le champ de l'étiquette dans la réponse.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.
Pour afficher les étiquettes d'un bucket, suivez les instructions permettant d'afficher les métadonnées d'un bucket et recherchez le champ de l'étiquette dans la réponse.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.
Pour afficher les étiquettes d'un bucket, suivez les instructions permettant d'afficher les métadonnées d'un bucket et recherchez le champ de l'étiquette dans la réponse.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.
Pour afficher les étiquettes d'un bucket, suivez les instructions permettant d'afficher les métadonnées d'un bucket et recherchez le champ de l'étiquette dans la réponse.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.
Pour afficher les étiquettes d'un bucket, suivez les instructions permettant d'afficher les métadonnées d'un bucket et recherchez le champ de l'étiquette dans la réponse.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êteGET
Bucket incluant le paramètre de chaîne de requêtefields=labels
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=labels"
Où
BUCKET_NAME
correspond au nom du bucket dont vous souhaitez afficher les libellés. Exemple :my-bucket
La réponse est semblable à ceci :
{ "labels" : { (your_label_key): your_label_value }, }
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
Bucket et le paramètre de chaîne de requêtetagging
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
Où
BUCKET_NAME
correspond au nom du bucket dont vous souhaitez afficher les libellés. Exemple :my-bucket
La réponse est semblable à ceci :
<Tagging> <TagSet> <Tag> <Key>your_label_key</Key> <Value>your_label_value</Value> </Tag> </TagSet> </Tagging>
Étapes suivantes
- En savoir plus sur les tags de bucket.
- Obtenez des métadonnées de bucket supplémentaires.