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"
        },
    }
    ]
}