Gérer les libellés

Cloud Filestore 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 des libellés avec vos instances Cloud Filestore. 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 aide à organiser vos instances Cloud Filestore de Google Cloud Platform. Vous pouvez associer un libellé à chaque ressource, puis filtrer les ressources par libellé. Les informations sur les étiquettes sont transmises au système de facturation afin que vous puissiez consulter le détail des frais apparaissant sur votre facture en fonction des étiquettes.

Cas d'utilisation courants des étiquettes

Voici quelques cas d'utilisation courants des libellés :

  • Étiquettes d'équipe ou de centre de coûts : ajoutez des étiquettes en fonction de l'équipe ou du centre de coûts pour distinguer les instances Cloud 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.

  • Étiquettes de composants : par exemple, component:redis, component:frontend, component:ingest et component:dashboard.

  • Étiquettes d'environnement ou de préproduction : par exemple, environment:production et environment:test.

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

Exigences relatives aux étiquettes

Les étiquettes appliquées à une ressource doivent répondre aux exigences suivantes :

  • Chaque ressource peut posséder plusieurs étiquettes, jusqu'à un maximum de 64.
  • Chaque étiquette 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'une étiquette 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.

Ajouter ou mettre à jour les libellés d'une instance

Après avoir créé une instance Cloud Filestore, vous pouvez ajouter des libellés à une instance, ainsi que mettre à jour ou supprimer des libellés existants.

Console

  1. Accédez à la page des instances Cloud Filestore.
  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 nouveau 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é pour un libellé existant.

    Pour supprimer un libellé existant, cliquez sur le X à côté de celui-ci.

  5. Cliquez sur Enregistrer pour enregistrer les modifications.

gcloud

Modifiez les libellés d'une instance en exécutant la commande instances update qui remplace [VALUES_IN_BRACKETS] par les valeurs appropriées. Utilisez l'indicateur --update-labels pour ajouter de nouveaux libellés ou modifier les valeurs des libellés existants, l'indicateur --remove-labels pour supprimer un ou plusieurs libellés ou l'indicateur --clear-labels pour supprimer tous les libellés d'une instance.

gcloud filestore instances update [INSTANCE_ID] \
    --project=[PROJECT_ID] \
    --location=[LOCATION] \
    --update-labels [KEY=VALUE,[KEY=VALUE,…]] \
    --remove-labels [KEY,[KEY,…]] \
    --clear-labels

où les paramètres sont les suivants :

  • [INSTANCE_ID] est l'identifiant de l'instance à modifier.
  • [PROJECT_ID] est l'identifiant du projet GCP contenant l'instance. Vous pouvez ignorer cet indicateur si vous avez défini le projet gcloud par défaut et souhaitez l'utiliser.
  • [LOCATION] est la zone GCP dans laquelle se trouve l'instance Cloud Filestore. Exécutez la commande gcloud beta filestore locations list pour obtenir la liste des emplacements acceptés. Vous pouvez ignorer cet indicateur si vous avez défini l'emplacement gcloud par défaut au moyen de la commande gcloud config set filestore/location.
  • [KEY] est un nouveau libellé ou un libellé existant que vous souhaitez modifier ou supprimer.
  • [VALUE] est la valeur d'un libellé.

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 \
    --location=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 Cloud Filestore.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Cloud Filestore Documentation