Créer et gérer des libellés

Cloud Bigtable vous permet d'ajouter des libellés à vos instances. Les libellés sont des paires clé/valeur que vous pouvez utiliser pour regrouper des instances associées et stocker des métadonnées sur une instance.

Cette page explique comment utiliser les libellés avec vos instances Bigtable. Elle décrit également comment ajouter, mettre à jour et supprimer les libellés d'une instance.

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.

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

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.

Ajout ou mise à jour des libellés d'une instance

Après avoir créé une instance Bigtable, vous pouvez utiliser Google Cloud Console pour ajouter des libellés à l'instance et mettre à jour les libellés existants. Vous pouvez également utiliser l'API RPC Admin ou l'API REST Admin pour ajouter ou mettre à jour des libellés.

Pour ajouter ou mettre à jour des libellés pour une instance Bigtable à l'aide de Cloud Console, procédez comme suit:

  1. Ouvrez la liste des instances Bigtable dans Cloud Console.

    Ouvrir la liste des instances

  2. Cochez la case à côté de chaque instance dont vous souhaitez modifier les libellés.

  3. Si le panneau Libellés n'est pas visible, cliquez sur Afficher le panneau d'informations dans l'angle supérieur droit pour l'ouvrir.

  4. Ajoutez et mettez à jour les libellés si nécessaire.

    Pour ajouter un libellé, cliquez sur Ajouter un libellé, puis tapez la clé et la valeur du libellé.

    Pour modifier un libellé existant, mettez à jour sa valeur. Vous ne pouvez pas modifier la clé d'un libellé existant.

  5. Cliquez sur Enregistrer pour enregistrer les modifications.

Supprimer un libellé d'une instance

Pour supprimer un libellé d'une instance Bigtable à l'aide de Cloud Console, procédez comme suit:

  1. Ouvrez la liste des instances Bigtable dans Cloud Console.

    Ouvrir la liste des instances

  2. Cochez la case correspondant à chaque instance dont vous souhaitez supprimer les libellés.

  3. Si le panneau Libellés n'est pas visible, cliquez sur Afficher le panneau d'informations dans l'angle supérieur droit pour l'ouvrir.

  4. Cliquez sur le X situé en regard de chaque libellé à supprimer.

  5. Cliquez sur Enregistrer pour enregistrer les modifications.

Étape suivante

Découvrez comment modifier d'autres propriétés d'une instance Bigtable.