Signaler l'utilisation avec des libellés

Que sont les étiquettes ?

Une étiquette est une paire clé/valeur qui vous aide à organiser vos ressources 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 étiquettes :

  • Étiquettes d'équipe ou de centre de coûts : ajoutez des étiquettes basées sur l'équipe ou le centre de coûts pour distinguer les ressources appartenant à différentes équipes (par exemple, team:research et team:analytics). Vous pouvez utiliser ce type d'étiquette pour la comptabilité analytique ou la budgétisation.

  • Étiquettes 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.

  • Étiquettes d'état : par exemple, state:active, state:readytodelete et state:archive.

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.

Gérer les étiquettes dans Pub/Sub

Dans Pub/Sub, les étiquettes permettent souvent d'organiser les frais liés à un compte de facturation donné. Ces frais sont associés au compte de facturation du projet contenant la ressource demandée, mais vous pouvez établir des associations supplémentaires. Par exemple, un abonnement appartenant à un projet peut être créé pour un sujet qui dépend d'un autre projet. Vous pouvez utiliser des étiquettes dans le but d'associer ce sujet et cet abonnement à un centre de coûts commun.

Les ressources Pub/Sub n'héritent pas des étiquettes des unes des autres. Dans l'exemple ci-dessus, vous devez définir la même étiquette pour le sujet et pour l'abonnement afin d'associer ces frais.

Vous pouvez vous servir des fonctionnalités suivantes pour appliquer des étiquettes aux ressources Pub/Sub :