Créer et mettre à jour des étiquettes pour les projets

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 :

  1. Ouvrez la page Libellés dans la console Google Cloud.

    Ouvrir la page "Libellés"

  2. Sélectionnez le projet dans la liste déroulante Sélectionner un projet.

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

  4. Lorsque vous avez terminé, cliquez sur Enregistrer.

Pour ajouter des libellés à plusieurs projets en même temps, procédez comme suit :

  1. Ouvrez la page Gérer les ressources dans la console Google Cloud.

    Ouvrir la page "Gérer les ressources"

  2. Sur la page Gérer les ressources, sélectionnez les projets auxquels vous souhaitez ajouter des libellés.

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

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

  1. Ouvrez la page Étiquettes dans la console Google Cloud.

    Ouvrir la page "Libellés"

  2. Sélectionnez le projet dans la liste déroulante Sélectionner un projet.

  3. Mettez à jour les libellés de votre projet :

    1. Pour modifier un libellé, cliquez sur la valeur que vous souhaitez modifier, puis apportez les modifications souhaitées.
    2. Pour supprimer un libellé, maintenez le pointeur sur la clé ou la valeur, puis cliquez sur .
  4. Lorsque vous avez terminé, cliquez sur Enregistrer.

Pour mettre à jour des libellés dans plusieurs projets en même temps, procédez comme suit :

  1. Ouvrez la page Gérer les ressources dans la console Google Cloud.

    Ouvrir la page "Gérer les ressources"

  2. Sur la page Gérer les ressources, sélectionnez les projets dans lesquels vous souhaitez mettre à jour des libellés.

  3. Dans le panneau d'informations, cliquez sur l'onglet Libellés et mettez à jour les libellés des projets sélectionnés :

    1. Pour modifier un libellé, cliquez sur la valeur que vous souhaitez modifier, puis apportez les modifications souhaitées.
    2. Pour supprimer un libellé, maintenez le pointeur sur la clé ou la valeur, puis cliquez sur .
  4. 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éthode projects.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"
        },
    }
    ]
}