Ce document explique comment créer et mettre à jour des libellés pour des projets à l'aide de l'API Resource Manager et de la console Google Cloud. Il fournit des informations sur l'interprétation des coûts à l'aide d'étiquettes et sur les services compatibles avec les étiquettes.
Créer des libellés pour les projets
Console
Pour ajouter des libellés à un seul projet, procédez comme suit :
Ouvrez la page Libellés dans la console Google Cloud.
Sélectionnez le projet dans la liste déroulante Sélectionner un projet.
Pour ajouter une nouvelle entrée de libellé, cliquez sur + Ajouter un libellé et saisissez une clé de libellé et une valeur pour chaque libellé à ajouter.
Lorsque vous avez terminé, cliquez sur Enregistrer.
Pour ajouter des libellés à plusieurs projets en même temps, procédez comme suit :
Ouvrez la page Gérer les ressources dans la console Google Cloud.
Sur la page Gérer les ressources, sélectionnez les projets auxquels vous souhaitez ajouter des libellés.
Dans le panneau d'informations, dans l'onglet Libellés, cliquez sur + Ajouter un libellé, puis saisissez une clé et une valeur pour chaque libellé à ajouter.
Lorsque vous avez terminé, cliquez sur Enregistrer.
Après avoir ajouté des libellés, vous pouvez filtrer les projets en saisissant une clé de libellé ou une valeur dans la zone de filtre au-dessus de la liste des projets. La zone de filtre propose des clés et des valeurs afin que vous puissiez prévisualiser les résultats.
REST
Pour créer un projet doté d'un libellé, définissez le champ labels
lors de la création du projet.
Requête :
POST https://cloudresourcemanager.googleapis.com/v3/projects { "labels": { "color": "red" }, "name": "myproject", "projectId": "our-project-123" }
Réponse :
{ "projectNumber": "333197460082", "projectId": "our-project-123", "lifecycleState": "ACTIVE", "name": "myproject", "labels": { "color": "red" }, "createTime": "2016-01-12T22:18:28.633Z", }
Pour ajouter des libellés à des projets existants, procédez comme suit :
- Obtenez le projet à l'aide de la méthode
projects.get()
. - Modifiez le champ
labels
. - Mettez à jour le projet à l'aide de la méthode
projects.patch()
.
Une fois les libellés ajoutés, vous pouvez filtrer les projets en fonction de ces libellés. Pour en savoir plus sur l'utilisation des libellés pour filtrer les projets, consultez la section Répertorier des projets.
Mettre à jour les étiquettes des projets
Console
Pour mettre à jour les libellés d'un seul projet, procédez comme suit :Ouvrez la page Étiquettes dans la console Google Cloud.
Sélectionnez le projet dans la liste déroulante Sélectionner un projet.
Mettez à jour les libellés de votre projet :
- Pour modifier un libellé, cliquez sur la valeur que vous souhaitez modifier, puis apportez les modifications souhaitées.
- Pour supprimer un libellé, maintenez le pointeur sur la clé ou la valeur, puis cliquez sur .
Lorsque vous avez terminé, cliquez sur Enregistrer.
Pour mettre à jour des libellés dans plusieurs projets en même temps, procédez comme suit :
Ouvrez la page Gérer les ressources dans la console Google Cloud.
Sur la page Gérer les ressources, sélectionnez les projets dans lesquels vous souhaitez mettre à jour des libellés.
Dans le panneau d'informations, cliquez sur l'onglet Libellés et mettez à jour les libellés des projets sélectionnés :
- Pour modifier un libellé, cliquez sur la valeur que vous souhaitez modifier, puis apportez les modifications souhaitées.
- Pour supprimer un libellé, maintenez le pointeur sur la clé ou la valeur, puis cliquez sur .
Lorsque vous avez terminé, cliquez sur Enregistrer.
REST
Pour mettre à jour les libellés d'un projet, procédez comme suit :
Récupérez l'objet
project
à l'aide de la méthodeprojects.get()
.Modifiez les libellés que vous souhaitez mettre à jour.
Appelez la méthode
projects.patch
.
L'exemple suivant met à jour le libellé color:blue
:
L'extrait de code suivant remplace la valeur du libellé color
blue
par red
.
Requête :
PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
updateMask=labels
}
PROJECT_NAME
correspond au nom du projet que vous souhaitez mettre à jour.
Corps JSON de la requête :
{
"labels":
{
"color": "red"
}
}
Réponse :
{
"projects": [
{
"name": "projects/123456789012",
"parent": "folders/123456789012",
"projectId": "my-project",
"state": "ACTIVE",
"displayName": "PROJECT_NAME"
"createTime": "2013-11-13T20:31:53.308Z"
"updateTime": "2013-11-13T20:35:42.308Z"
"etag": "BwWUlZ6XEfY="
"labels": {
"color": "red"
},
}
]
}