Aperçu

Ce document présente brièvement les libellés et leurs fonctionnalités.

Qu'est-ce qu'un libellé ?

Un libellé est une paire clé-valeur que vous pouvez attribuer aux ressources Google Cloud . Elle vous aide à organiser ces ressources et à gérer vos coûts à grande échelle avec la précision dont vous avez besoin. Vous pouvez associer une étiquette à chaque ressource, puis filtrer les ressources par étiquette. Les informations sur les étiquettes sont transmises au système de facturation. Ainsi, vous pouvez trier vos frais facturés par étiquette. Grâce aux rapports de facturation intégrés, vous pouvez filtrer et regrouper les coûts par libellé de ressource. Vous pouvez également utiliser des étiquettes pour interroger les exportations de données de facturation.

Exigences relatives aux libellés

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

• Chaque ressource peut comporter jusqu'à 64 étiquettes.
• 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. Les clés doivent commencer par une lettre minuscule ou un caractère international.
• La partie clé d'un libellé doit être unique au sein d'une ressource spécifique. Cependant, vous pouvez utiliser la même clé avec plusieurs ressources.

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.

Cas d'utilisation courants des libellés

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.

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

• Étiquettes de propriété : permettent d'identifier les équipes responsables des opérations (par exemple, team:shopping-cart).

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

Remarque : Ne faites pas figurer des informations sensibles dans les étiquettes, y compris des informations personnelles telles que le nom ou le titre d'une personne. Les libellés ne sont pas conçus pour gérer des informations sensibles.

Nous vous déconseillons de créer de grands nombres d'étiquettes uniques (par exemple, pour les horodatages ou les valeurs individuelles pour chaque appel d'API). Le problème avec cette approche est que lorsque les valeurs changent fréquemment ou que des clés encombrent le catalogue, il est difficile de filtrer efficacement les ressources et de créer des rapports associés.

Libellés et tags

Pour les ressources, les libellés peuvent être utilisés comme des annotations qu'il est possible d'interroger. Cependant, ils ne peuvent pas être utilisés pour définir des conditions dans le cadre de vos stratégies. Les tags permettent d'autoriser ou de refuser des règles de manière conditionnelle selon qu'une ressource possède un tag spécifique ou non, grâce à un contrôle ultraprécis sur les règles. Pour en savoir plus, consultez la présentation des tags.

Autorisations

Les autorisations suivantes sont requises lorsque vous devez ajouter, modifier et afficher des libellés pour les projets :

• 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.update.
• 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.

Comprendre les coûts à l'aide de libellés

Vous pouvez associer un libellé à une ressource, puis filtrer les ressources par libellé. Les informations sur les étiquettes sont transmises au système de facturation, ce qui vous permet de consulter le détail des frais apparaissant sur votre facture en fonction des étiquettes.

Voici quelques exemples d'utilisation des libellés pour comprendre les coûts :

• Vous pouvez ajouter des libellés tels que costcenter=cost_center_name, service=service_name et environment=environment_name à vos VM ou à vos buckets Cloud Storage. Cela vous permet de comprendre où vos ressources sont déployées, dans quel but et le centre de coûts auquel elles doivent être imputées.
• Vous pouvez activer l'exportation des données de facturation vers BigQuery. Les libellés sont exportés vers BigQuery avec les ressources Google Cloud correspondantes et leur utilisation. Cela vous permet de surveiller des aspects tels que le coût d'exécution du service de panier d'achat dans l'application ou le coût des machines de test des développeurs.
• Vous pouvez utiliser BigQuery en combinaison avec des libellés pour comprendre le coût de toutes les ressources du système de test par rapport aux ressources de production ou le coût d'un service particulier.

Exemple

Dans cet exemple, le coût des services playlist pour un projet est déterminé en exportant l'utilisation et les libellés vers BigQuery. Pour ce faire, commencez par activer l'exportation de la facturation vers BigQuery. labels-demo-prj est la source de votre utilisation des ressources et labels_demo_bqexport est l'ensemble de données de destination où sont stockées les données d'utilisation. Une fois que vous avez exporté votre utilisation et vos libellés vers BigQuery, vous pouvez déterminer le montant de vos coûts de service playlist.

Vous trouverez ci-dessous des informations sur l'utilisation de Compute Engine et les coûts associés dans BigQuery.

Remarque : Lorsque vous filtrez la répartition de la facturation par clés de libellé, vous ne pouvez pas sélectionner les libellés appliqués à un projet. Vous pouvez sélectionner les autres libellés créés par l'utilisateur que vous avez configurés et appliqués aux services Google Cloud .