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. Vous pouvez utiliser des libellés pour regrouper des instances associées et stocker des métadonnées sur une instance.

Que sont les libellés ?

Un libellé est une paire clé/valeur qui vous permet d'organiser vos instances Google Cloud Filestore. 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 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.

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

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 Cloud Console, 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 dans l'angle supérieur droit pour l'ouvrir.

  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 des libellés existants, utilisez l'option --update-labels. Pour supprimer un ou plusieurs libellés, utilisez l'option --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 Cloud 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 commande gcloud filestore zones list pour obtenir la liste des zones compatibles. 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

Étape suivante

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