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. Ils vous aident à organiser ces ressources et à gérer vos coûts à grande échelle, avec la précision dont vous avez besoin. 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 pour vous permettre de ventiler les frais facturés par libellé. Les rapports de facturation intégrés vous permettent de filtrer et de 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 libellés.
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 recommandons de ne pas créer de grands nombres d'étiquettes uniques, tels que pour des horodatages ou des valeurs individuelles pour chaque appel d'API. Le problème avec cette approche est que lorsque les valeurs changent fréquemment ou avec des clés qui encombrent le catalogue, il est difficile de filtrer efficacement les ressources et de générer des rapports sur ces ressources.

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, en offrant un contrôle ultraprécis sur les règles. Pour en savoir plus, consultez la page Présentation des balises.

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

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

Accéder à la page des instances Filestore
Cochez la case située à côté de chaque instance dont vous souhaitez modifier les libellés.
Cliquez sur Afficher le panneau d'informations.

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

Opération	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é.

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

Étapes suivantes

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