Organisez les ressources avec des balises

Introduction

L'équipe de production de rapports souhaite trouver ses paramètres de test par équipe et par environnement, même lorsque leurs noms diffèrent. Vous ajouterez des balises de propriétaire, repérerez un libellé d'environnement incorrect et le corrigerez sans modifier les paramètres stockés.

Terminez d'abord les laboratoires sur l'espace de travail, les ressources régionales et les requêtes CLI. Les outils et les quatre ressources sont préparés dans un nouvel environnement. Travaillez dans Terminal et observez les mêmes balises et résultats filtrés dans AWS View en haut.

Lien avec les certifications

Vue d’ensemble du lab

Étiquetez le paramètre d'exportation financière

Dans cette étape, vous associerez des libellés d'équipe et d'environnement au paramètre d'exportation financière.

Le dernier laboratoire trouvait les ressources grâce à un préfixe de nom commun. Les noms ne décrivent pas toujours leur équipe ou leur environnement. Une balise, ou tag, ajoute une clé et une valeur distinctes à une ressource, par exemple owner=finance ou environment=staging. Ces libellés vous aident à trouver des ressources liées sans les renommer.

Listez les paramètres :

aws ssm describe-parameters

Lisez leurs descriptions : /labex/tagging/export-format et /labex/tagging/archive-format sont des paramètres financiers de préproduction, ou staging, utilisés pour les tests. Les deux ressources /labex/reference/ appartiennent à d'autres équipes ; laissez-les inchangées.

Les opérations sur les balises identifient le type de ressource et son nom. Pour un paramètre, conservez --resource-type Parameter et utilisez son nom complet comme --resource-id. Examinez les balises du paramètre d'exportation :

aws ssm list-tags-for-resource \
  --resource-type Parameter \
  --resource-id /labex/tagging/export-format

TagList vaut [] : cette ressource n'a pas encore de balises. Ajoutez deux libellés. Chaque Key=...,Value=... fournit une balise, et un espace les sépare :

aws ssm add-tags-to-resource \
  --resource-type Parameter \
  --resource-id /labex/tagging/export-format \
  --tags Key=owner,Value=finance Key=environment,Value=staging

Utilisez les clés en minuscules exactement comme indiqué ; les balises sont sensibles à la casse. Une écriture réussie n'affiche normalement rien. Relisez le résultat :

aws ssm list-tags-for-resource \
  --resource-type Parameter \
  --resource-id /labex/tagging/export-format

Les deux libellés apparaissent. Observez AWS View en haut : le paramètre d'exportation fait partie de sa sélection de préproduction financière. Sa valeur stockée reste csv.

Trouvez les ressources par propriétaire

Dans cette étape, vous ajouterez le propriétaire du paramètre d'archivage et trouverez les deux ressources financières avec un filtre de balise.

Le paramètre d'archivage est également attribué à l'équipe financière. Ajoutez son libellé de propriétaire sans modifier les autres balises :

aws ssm add-tags-to-resource \
  --resource-type Parameter \
  --resource-id /labex/tagging/archive-format \
  --tags Key=owner,Value=finance

Lisez la liste complète des balises :

aws ssm list-tags-for-resource \
  --resource-type Parameter \
  --resource-id /labex/tagging/archive-format

Vous devriez voir owner=finance et une balise existante environment=production. La description indiquait qu'il s'agit d'un paramètre de préproduction ; gardez cette incohérence à l'esprit pour l'étape suivante.

Utilisez le modèle de filtrage du laboratoire précédent, cette fois pour une balise. Key=tag:owner sélectionne la balise de propriétaire et Option=Equals exige une valeur exacte :

aws ssm describe-parameters \
  --parameter-filters Key=tag:owner,Option=Equals,Values=finance \
  --query 'Parameters[].Name'

Les deux noms financiers apparaissent. Les ressources humaines et la plateforme sont en dehors de cette sélection. Les libellés décrivent les informations que vous fournissez ; le service ne détermine pas à votre place le propriétaire ou l'environnement d'une équipe.

Corrigez le libellé d'environnement

Dans cette étape, vous corrigerez l'environnement mal étiqueté du paramètre d'archivage et rétablirez la sélection complète de préproduction financière.

Une liste fondée uniquement sur l'équipe inclut les deux ressources financières. Pour trouver ses paramètres de test, exigez les deux balises : owner=finance et environment=staging. Fournissez deux filtres séparés par un espace :

aws ssm describe-parameters \
  --parameter-filters Key=tag:owner,Option=Equals,Values=finance Key=tag:environment,Option=Equals,Values=staging \
  --query 'Parameters[].Name'

Seul le paramètre d'exportation apparaît. Celui d'archivage existe, mais sa balise incorrecte production l'exclut de cette vue.

Confirmez les données stockées du paramètre d'archivage avant de corriger son libellé :

aws ssm get-parameter --name /labex/tagging/archive-format

Sa valeur est json, en Version 1. Sa description dans l'inventaire l'identifie comme un paramètre d'archivage financier de préproduction. Corrigez la balise d'environnement avec la même opération d'ajout : fournir une clé existante remplace sa valeur et laisse les autres balises intactes.

aws ssm add-tags-to-resource \
  --resource-type Parameter \
  --resource-id /labex/tagging/archive-format \
  --tags Key=environment,Value=staging

Vous corrigez un libellé pour qu'il corresponde à une ressource de test existante ; vous ne déplacez pas une application de production vers la préproduction. Relisez les libellés :

aws ssm list-tags-for-resource \
  --resource-type Parameter \
  --resource-id /labex/tagging/archive-format

Le propriétaire et l'environnement correspondent maintenant à la tâche. Relancez la sélection :

aws ssm describe-parameters \
  --parameter-filters Key=tag:owner,Option=Equals,Values=finance Key=tag:environment,Option=Equals,Values=staging \
  --query 'Parameters[].Name'

Les deux noms financiers apparaissent. Relisez les données stockées :

aws ssm get-parameter --name /labex/tagging/archive-format

Son nom, son ARN, sa valeur json et sa Version 1 restent inchangés. Dans AWS View, les deux ressources apparaissent maintenant dans la préproduction financière, et les ressources des autres équipes restent intactes.

Résumé

Vous avez ajouté des tags métier et corrigé une classification sans modifier les données. Passez à un court challenge accompagné d’indices pour pratiquer ces compétences.

Pour approfondir ce sujet, consultez la documentation AWS : Étiquettes et organisation des ressources.