Introduction
Une équipe de production de rapports doit réviser ses paramètres de test financiers sans modifier ceux de production ou d'une autre équipe. Vous trouverez les bonnes ressources, rendrez la liste plus lisible et définirez CSV comme format d'exportation.
Terminez d'abord les laboratoires sur l'espace de travail et les ressources régionales. La connexion CLI et les ressources sont préparées dans un nouvel environnement ; aucun fichier ni identifiant d'accès précédent n'est nécessaire. Utilisez Terminal pour les commandes et AWS View, à côté, pour observer les changements.
Lien avec les certifications
Ce laboratoire propose une pratique des sujets d’examen suivants.
- Cloud Practitioner (CLF-C02) · Tâche 3.1: Requêtes CLI et inventaires opérationnels à portée limitée.
Trouvez les paramètres de test financiers
Dans cette étape, vous réduirez une liste de ressources variées aux paramètres financiers attribués à cette révision.
Le laboratoire précédent a montré comment une région sélectionne un emplacement. Ici, la région par défaut préparée est us-east-1 : les commandes sans --region utilisent cet emplacement. Vous pouvez toujours indiquer explicitement --region us-east-1.
Rejoignez l'espace de travail :
cd /home/labex/project
Un inventaire de ressources est une liste de ressources. Consultez l'inventaire de paramètres préparé :
aws ssm describe-parameters
Examinez chaque Name et Description. La préproduction, appelée staging, est un environnement de test utilisé avant de modifier la production, où s'exécute le travail habituel de l'entreprise. La liste comprend les paramètres financiers de préproduction et de production, ainsi que ceux des ressources humaines en préproduction. Vos trois ressources commencent par /labex/inventory/finance/staging/.
La Console officielle présente les métadonnées des paramètres dans un tableau de ressources. Comparez ses colonnes Name et Type avec les champs renvoyés par describe-parameters. Les noms de l'exemple diffèrent ; ce laboratoire utilise des paramètres String :
Source : AWS Blog.
La liste est assez courte pour être parcourue, mais un filtre rend votre périmètre plus clair. --parameter-filters demande au service de renvoyer les enregistrements correspondants. Key=Name sélectionne les noms, Option=BeginsWith vérifie leur début et Values=... fournit ce début :
aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/
Vous devriez voir trois noms : report-format, report-owner et review-status. Leur ordre peut varier.
Schéma conceptuel : un filtre modifie la liste renvoyée, pas les ressources. Les autres paramètres existent toujours.
Enregistrez le début de cette révision de configuration en mettant à jour son état existant :
aws ssm put-parameter --name /labex/inventory/finance/staging/review-status --type String --value in-review --overwrite
Vous avez appris put-parameter et --overwrite dans le premier laboratoire. AWS View affiche désormais in-review dans la préproduction financière. Laissez la production financière et les ressources humaines inchangées.
Affichez les noms et modifiez le format d'exportation
Dans cette étape, vous afficherez uniquement les noms correspondants, puis modifierez le format d'exportation de la préproduction financière.
La réponse contient plus de champs que nécessaire pour le moment. --query sélectionne des parties d'une réponse ; il ne modifie pas les données stockées. Dans 'Parameters[].Name', Parameters[] désigne les enregistrements renvoyés et .Name sélectionne leurs noms. Conservez l'expression entre guillemets simples.
Ajoutez cette sélection à votre filtre existant :
aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ --query 'Parameters[].Name'
La réponse est une liste JSON de trois noms. Remarquez que le filtre choisit toujours les ressources ; la requête choisit les champs à afficher.
Schéma conceptuel : sélectionner Name masque les autres champs dans cette réponse ; cela ne les efface pas.
Pour un affichage plus compact, ajoutez --output table :
aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ --query 'Parameters[].Name' --output table
Les trois mêmes noms apparaissent dans un tableau. Le format de sortie modifie uniquement la présentation.
Lisez le paramètre exact du format de préproduction à partir de son nom :
aws ssm get-parameter --name /labex/inventory/finance/staging/report-format
Repérez Value : sa valeur est json. Il s'agit du format d'exportation de l'application, distinct du format JSON de la réponse CLI. L'outil qui importe les rapports en aval a besoin de CSV ; mettez donc ce paramètre à jour :
aws ssm put-parameter --name /labex/inventory/finance/staging/report-format --type String --value csv --overwrite
Relisez-le :
aws ssm get-parameter --name /labex/inventory/finance/staging/report-format
Sa valeur est maintenant csv. Dans AWS View, comparez la préproduction financière avec la production et les ressources humaines :
Exemple de résultat : la préproduction financière utilise csv ; la production conserve json et les ressources humaines conservent xlsx. L'état de votre révision est toujours in-review.
Confirmez les paramètres et terminez la révision
Dans cette étape, vous lirez les deux valeurs révisées et indiquerez que la configuration financière de préproduction est prête.
Vous pouvez aussi sélectionner un champ dans une seule ressource. 'Parameter.Value' lit la valeur contenue dans Parameter ; --output text l'affiche sans les guillemets JSON :
aws ssm get-parameter --name /labex/inventory/finance/staging/report-format --query 'Parameter.Value' --output text
La réponse est csv. Confirmez à qui appartient cette configuration de rapports :
aws ssm get-parameter --name /labex/inventory/finance/staging/report-owner --query 'Parameter.Value' --output text
La réponse est finance. Ce sont des valeurs stockées ; la liste précédente de métadonnées affichait plutôt les noms et les descriptions.
Indiquez maintenant que la révision terminée est prête :
aws ssm put-parameter --name /labex/inventory/finance/staging/review-status --type String --value ready --overwrite
Relisez ce résultat :
aws ssm get-parameter --name /labex/inventory/finance/staging/review-status --query 'Parameter.Value' --output text
La réponse est ready. AWS View affiche la préproduction financière avec le format csv, le propriétaire finance et l'état ready. Vous avez révisé des paramètres, sans déployer une application de production de rapports.
Nettoyez l'espace de noms sélectionné
Dans cette étape, vous supprimerez uniquement les ressources financières de préproduction après la réussite des vérifications de révision.
Une requête CLI façonne uniquement une réponse ; elle ne constitue pas une protection durable pour une suppression ultérieure. Gardez le périmètre du nettoyage explicite. delete-parameters accepte une liste de noms exacts avec --names ; voici les trois ressources qui appartiennent à cet exercice :
aws ssm delete-parameters --names /labex/inventory/finance/staging/report-format /labex/inventory/finance/staging/report-owner /labex/inventory/finance/staging/review-status
Le champ DeletedParameters de la réponse liste les noms supprimés ; InvalidParameters devrait être vide. Vérifiez le préfixe de préproduction avec une requête de service réussie :
aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ --query 'Parameters[].Name' --output json
Le résultat est []. Une erreur de connexion ou d'authentification correspond à une observation échouée, pas à une preuve de suppression.
Lisez les noms de l'inventaire restant :
aws ssm describe-parameters --query 'Parameters[].Name' --output table
Il reste trois ressources : le format et l'état de révision de la production financière, ainsi que le format de préproduction des ressources humaines. Vérifiez leurs valeurs sans les modifier :
aws ssm get-parameter --name /labex/inventory/finance/production/report-format --query 'Parameter.Value' --output text
aws ssm get-parameter --name /labex/inventory/finance/production/review-status --query 'Parameter.Value' --output text
aws ssm get-parameter --name /labex/inventory/hr/staging/report-format --query 'Parameter.Value' --output text
Les valeurs restent json, ready et xlsx. AWS View affiche No parameters pour la préproduction financière tandis que les autres groupes contiennent toujours leurs paramètres. La vérification indépendante du nettoyage contrôle aussi la conservation de leurs versions et descriptions d'origine.
Résumé
Vous avez trouvé la préproduction financière avec un filtre de préfixe de nom, sélectionné des noms ou une valeur unique avec --query et utilisé une sortie en tableau ou en texte pour améliorer la lisibilité. Vous avez mis à jour uniquement la configuration attribuée et l'avez nettoyée en conservant les ressources des autres équipes.
Le laboratoire suivant, Organisez les ressources avec des balises, ajoute des libellés d'équipe et d'environnement afin de regrouper les ressources même lorsque leurs noms suivent des modèles différents.
