Les étiquettes vous permettent d'organiser vos projets Google Cloud et de suivre les coûts entre les équipes ou les environnements. Pour gérer les étiquettes de projet, vous pouvez utiliser la consoleGoogle Cloud , la Google Cloud CLI ou l'API Cloud Resource Manager.
Les libellés ne s'appliquent qu'aux projets. Les dossiers et les ressources d'organisation ne sont pas compatibles avec les étiquettes, et les étiquettes que vous associez à un projet ne sont pas automatiquement propagées aux ressources enfants. Pour appliquer ou mettre à jour des étiquettes sur des ressources de service spécifiques telles que des instances Compute Engine ou des buckets Cloud Storage, consultez la documentation de la ressource ou la page Services compatibles avec les étiquettes. Par exemple, Pub/Sub accepte les étiquettes pour la facturation du débit des sujets et des abonnements, mais les SKU de facturation de sortie n'acceptent pas les étiquettes.
Créer des étiquettes pour les projets
Console
Pour ajouter des libellés à 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.
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.
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 étiquettes à 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_IDest l'ID du projet que vous souhaitez créer ou mettre à jour.KEY1=VALUE1est une paire clé-valeur pour l'étiquette que vous souhaitez ajouter.
REST
Pour créer un nouveau projet avec une étiquette, 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"
Mettre à jour les libellés 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 une étiquette, 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 une étiquette, 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.
gcloud
Pour mettre à jour les libellés d'un projet à l'aide de gcloud CLI, utilisez la commande gcloud projects update avec l'option --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 étiquettes spécifiques :
gcloud projects update PROJECT_ID \
--remove-labels=KEY1,KEY2
Pour supprimer toutes les étiquettes d'un projet :
gcloud projects update PROJECT_ID \
--clear-labels
REST
Pour mettre à jour les étiquettes 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 est l'ID du projet que vous souhaitez mettre à jour.