Créer et mettre à jour des libellés pour des projets

Console

Pour ajouter des libellés à un seul projet, procédez comme suit :

1. Ouvrez la page Libellés dans la Cloud de Confiance console.

   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 Cloud de Confiance console.

   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 Étiquettes, cliquez sur + Ajouter une étiquette et saisissez une clé d'étiquette et une valeur pour chaque étiquette à ajouter.

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

Après avoir ajouté des étiquettes, vous pouvez filtrer les projets en saisissant une clé d'étiquette 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.

gcloud

Pour créer un nouveau projet avec des libellés à l'aide de gcloud CLI, utilisez la commande gcloud projects create avec l'option --labels :

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

Pour ajouter des libellés à un projet existant, utilisez la commande gcloud projects update avec l'option --update-labels :

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Où :

• PROJECT_ID correspond à l'ID du projet que vous souhaitez créer ou mettre à jour.
• KEY1=VALUE1 correspond à une paire clé-valeur pour le libellé que vous souhaitez ajouter.

REST

Pour créer un nouveau projet avec un libellé, incluez le champ labels lorsque vous envoyez une requête POST à la méthode projects.create :

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

Pour ajouter des libellés à un projet existant, utilisez la méthode projects.patch :

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Console

1. Ouvrez la page Libellés dans la Cloud de Confiance console.

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

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 Cloud de Confiance console.

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

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

gcloud

Pour mettre à jour les libellés d'un projet à l'aide de gcloud CLI, utilisez la commande gcloud projects update avec les options --update-labels, --remove-labels ou --clear-labels.

Pour ajouter ou mettre à jour des étiquettes, procédez comme suit :

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

Pour supprimer des libellés spécifiques, procédez comme suit :

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

Pour supprimer tous les libellés d'un projet, procédez comme suit :

gcloud projects update PROJECT_ID \
    --clear-labels

REST

Pour mettre à jour les libellés d'un projet à l'aide de l'API, envoyez une requête PATCH à la méthode projects.patch :

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

Où PROJECT_ID correspond à l'ID du projet que vous souhaitez mettre à jour.