Créer et gérer des libellés

Cette page présente brièvement les libellés, et explique comment les créer et les gérer à l'aide de l'API Resource Manager et de Google Cloud Console.

Que sont les libellés ?

Un libellé est une paire clé/valeur qui vous permet d'organiser plus efficacement vos instances Google Cloud. Vous pouvez associer un libellé à chaque ressource, puis filtrer les ressources par libellé. Les informations sur les libellés sont transmises au système de facturation afin que vous puissiez consulter le détail des frais apparaissant sur votre facture en fonction des libellés.

Cas d'utilisation courants des libellés

Nous vous recommandons de ne pas créer de grands nombres de libellés uniques, tels que pour des horodatages ou des valeurs individuelles pour chaque appel d'API. Voici quelques cas d'utilisation courants des libellés :

  • Libellés d'équipe ou de centre de coût : ajoutez des libellés en fonction de l'équipe ou du centre de coût pour distinguer les instances appartenant à différentes équipes (par exemple, team:research et team:analytics). Vous pouvez utiliser ce type de libellés pour la comptabilité analytique ou la budgétisation.

  • Libellés de composant : par exemple, component:redis, component:frontend, component:ingest et component:dashboard.

  • Libellés d'environnement ou d'étape : par exemple, environment:production et environment:test.

  • Libellés d'état : par exemple, state:active, state:readytodelete et state:archive.

  • Libellés de machine virtuelle : un libellé peut être associé à une machine virtuelle. Les tags de machine virtuelle que vous avez définis précédemment apparaissent sous la forme d'un libellé sans valeur.

Exigences applicables aux libellés

Les libellés appliqués à une ressource doivent répondre aux exigences suivantes :

  • Chaque ressource peut posséder plusieurs libellés, jusqu'à un maximum de 64.
  • Chaque libellé doit correspondre à une paire clé/valeur.
  • Les clés doivent comporter un (1) caractère au minimum et 63 au maximum, et ne peuvent pas être vides. Les valeurs peuvent être vides et comporter 63 caractères au maximum.
  • Les clés et les valeurs ne peuvent contenir que des lettres minuscules, des chiffres, des traits de soulignement et des tirets. Tous les caractères doivent être au format d'encodage UTF-8. Les caractères internationaux sont autorisés.
  • La partie clé d'un libellé doit être unique. Cependant, vous pouvez utiliser la même clé avec plusieurs ressources.
  • Les clés doivent commencer par une lettre minuscule ou un caractère international.

Ces limites s'appliquent à la clé et à la valeur de chaque libellé, ainsi qu'aux ressources Google Cloud individuelles associées à des libellés. Vous pouvez appliquer autant de libellés que vous le souhaitez à toutes les ressources d'un projet.

Créer et gérer des libellés à l'aide de l'API Resource Manager

Pour créer un projet doté d'un libellé, définissez le champ labels lors de la création du projet.

REST

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

Python

...

  project = crm.projects().create(
    body={
        'project_id': flags.projectId,
        'name': 'myproject',
        labels.color: "red"
}).execute()

...


Pour ajouter des libellés à des projets existants :

  • Obtenez le projet à l'aide de la méthode get().
  • Modifiez le champ labels.
  • Mettez à jour le projet à l'aide de la méthode patch().

Pour en savoir plus sur la mise à jour des libellés d'un projet, consultez la section Mettre à jour un projet.

Pour en savoir plus sur l'utilisation des libellés pour filtrer les projets, consultez la section Répertorier des projets.

Autorisations

Vous pouvez ajouter ou modifier un libellé en appelant la méthode projects.patch(). Pour ce faire, vous devez disposer de l'autorisation resourcemanager.projects.patch.

Vous pouvez afficher le libellé d'un projet en appelant la méthode projects.get(). Pour ce faire, vous devez disposer de l'autorisation resourcemanager.projects.get.

Créer et gérer des libellés à l'aide de Cloud Console

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

  1. Ouvrez la page Libellés de Cloud 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 de Cloud Console.
    Ouvrir la page "Gérer les ressources"
  2. Sur la page Gérer les ressources, sélectionnez l'organisation et les projets auxquels vous souhaitez ajouter des libellés.
  3. Dans le panneau de droite, dans l'onglet Libellés, 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.

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.

Services compatibles avec les libellés

Les libellés sont compatibles avec les services Google Cloud suivants :

  • AI Platform
  • App Engine (environnements flexible et standard)
  • Artifact Registry
  • BigQuery
  • Certificate Authority Service
  • Cloud Bigtable
  • Cloud Deployment Manager
  • Cloud Functions
  • API Cloud Healthcare
  • Cloud Key Management Service
  • Cloud Run
  • Cloud Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc
  • Filestore
  • Google Kubernetes Engine
  • Mise en réseau
  • Pub/Sub
  • Resource Manager (projets uniquement)