Gérer les libellés

Cette page vous explique comment utiliser des libellés avec vos instances Filestore. Elle explique également comment ajouter, mettre à jour et supprimer les libellés d'une instance. Les libellés vous permettent de regrouper des instances associées et de stocker des métadonnées sur une instance.

Qu'est-ce qu'un libellé ?

Un libellé est une paire clé-valeur que vous pouvez attribuer aux instances Google Cloud Filestore. 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 étiquette 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 :

  • 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 Filestore 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 propriété : permettent d'identifier les équipes responsables des opérations (par exemple, team:shopping-cart).

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.

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

Vous pouvez ajouter des libellés à une instance Filestore lorsque vous créez l'instance. Une fois l'instance créée, vous pouvez ajouter d'autres libellés à l'instance, ainsi que mettre à jour ou supprimer des libellés existants.

Console

  1. Dans la console Google Cloud, accédez à la page "Instances Filestore".

    Accéder à la page des instances Filestore

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

  3. Cliquez sur Afficher le panneau d'informations.

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

    Operation Instructions
    Ajouter un libellé Cliquez sur Ajouter un libellé, puis saisissez la clé et la valeur du libellé.
    Mettre à jour un libellé Mettez à jour le champ Valeur. Vous ne pouvez pas mettre à jour la clé d'un libellé existant.
    Supprimer un libellé Cliquez sur Supprimer l'élément à côté du libellé.
  5. Cliquez sur Enregistrer pour enregistrer vos modifications une fois terminées.

gcloud

Vous pouvez modifier les libellés d'une instance Filestore en exécutant la commande instances update. Pour ajouter de nouveaux libellés ou modifier les valeurs de libellés existants, utilisez la --update-labels. Pour supprimer un ou plusieurs libellés, utilisez la méthode --remove-labels. . L'option --clear-labels supprime tous les libellés d'une instance.

gcloud filestore instances update instance-id \
    --project=project-id \
    --zone=zone \
    --update-labels key=value,[key=value,…] \
    --remove-labels key,[key,…] \
    --clear-labels

où :

  • instance-id est l'ID de l'instance à modifier.
  • project-id est l'ID du projet Google Cloud qui contenant l'instance Filestore. Vous pouvez ignorer cette option si l'instance Filestore se trouve dans le projet par défaut gcloud. Vous pouvez définir le projet par défaut en exécutant la commande suivante :

     gcloud config set project project-id
    
  • zone est la zone où se trouve l'instance Filestore. Exécutez la gcloud filestore zones list. pour obtenir la liste des zones prises en charge. Vous pouvez ignorer cette option si l'instance Filestore se trouve dans la zone par défaut gcloud. Vous pouvez définir la zone par défaut en exécutant la commande suivante :

     gcloud config set filestore/zone zone
    
  • key est un nouveau libellé ou un libellé existant que vous souhaitez modifier ou supprimer.

  • value est la valeur d'un libellé.

Exemple

L'exemple suivant met à jour l'instance nfs-server en ajoutant le libellé status, en mettant à jour la valeur du libellé dept et en supprimant le libellé admin.

gcloud filestore instances update nfs-server \
    --project=myproject \
    --zone=us-central1-c \
    --update-labels status=active \
    --update-labels dept=accounting \
    --remove-labels admin

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 Composer
  • Bigtable
  • Cloud Deployment Manager
  • Fonctions Cloud Run
  • API Cloud Healthcare
  • Cloud Key Management Service
  • Cloud Run
  • Spanner
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc
  • Filestore
  • Google Kubernetes Engine
  • Mise en réseau
  • Pub/Sub
  • Resource Manager (projets uniquement)

Étape suivante

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