Ressourcen mit der AWS CLI finden

AWSBeginner
Jetzt üben

Einführung

Ein Berichtsteam muss seine Finance-Testeinstellungen prüfen, ohne die Produktion oder die Einstellungen eines anderen Teams zu verändern. Du findest die richtigen Ressourcen, machst die Liste leichter lesbar und aktualisierst das Exportformat auf CSV.

Schließe zuerst die Labs zum Arbeitsbereich und zu regionalen Ressourcen ab. Die CLI-Verbindung und Ressourcen sind in einer neuen Umgebung vorbereitet; frühere Dateien oder Zugangsdaten werden nicht benötigt. Verwende Terminal für Befehle und AWS View daneben, um die Änderungen zu beobachten.

Bezug zu Zertifizierungen

Dieses Lab bietet praktische Übungen zu den folgenden Prüfungsthemen.

Finde die Finance-Testeinstellungen

In diesem Schritt grenzt du eine gemischte Ressourcenliste auf die Finance-Einstellungen ein, die dieser Prüfung zugeordnet sind.

Das vorherige Lab zeigte, wie Region einen Standort auswählt. Hier ist us-east-1 als Standard vorbereitet: Befehle ohne --region verwenden diesen Standort. Du kannst weiterhin ausdrücklich --region us-east-1 angeben.

Wechsle in den Arbeitsbereich:

cd /home/labex/project

Ein Ressourceninventar ist eine Liste von Ressourcen. Sieh dir das vorbereitete Parameterinventar an:

aws ssm describe-parameters

Betrachte jeweils Name und Description. Staging ist eine Testumgebung, die vor Änderungen an der Produktion verwendet wird, wo die reguläre Geschäftstätigkeit stattfindet. Die Liste enthält Einstellungen für Finance Staging, Finance Production und HR Staging. Deine drei Ressourcen beginnen mit /labex/inventory/finance/staging/.

Die offizielle Console stellt Parametermetadaten als Ressourcentabelle dar. Vergleiche ihre Spalten Name und Type mit den von describe-parameters gelieferten Feldern. Die Beispielnamen unterscheiden sich; dieses Lab verwendet String-Parameter:

My parameters-Tabelle der offiziellen Parameter Store Console mit Ressourcennamen und Typen

Quelle: AWS Blog.

Die Liste ist klein genug zum Überfliegen, aber ein Filter macht deinen Umfang deutlicher. --parameter-filters fordert den Dienst auf, passende Datensätze zurückzugeben. Key=Name wählt Namen aus, Option=BeginsWith prüft ihren Anfang und Values=... gibt diesen Anfang vor:

aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/

Du solltest drei Namen sehen: report-format, report-owner und review-status. Ihre Reihenfolge kann variieren.

Ein Präfixfilter wählt Finance Staging aus und lässt andere Ressourcen außerhalb des Ergebnisses

Konzeptdiagramm: Ein Filter verändert die zurückgegebene Liste, nicht die Ressourcen. Die anderen Einstellungen existieren weiterhin.

Halte den Beginn dieser Konfigurationsprüfung fest, indem du ihren vorhandenen Status aktualisierst:

aws ssm put-parameter --name /labex/inventory/finance/staging/review-status --type String --value in-review --overwrite

put-parameter und --overwrite hast du im ersten Lab kennengelernt. AWS View zeigt jetzt in-review in Finance Staging. Lasse Finance Production und HR unverändert.

Zeige Namen an und aktualisiere das Exportformat

In diesem Schritt zeigst du nur die passenden Namen an und änderst anschließend das Exportformat von Finance Staging.

Die Antwort enthält mehr Felder, als du derzeit benötigst. --query wählt Teile einer Antwort aus; es verändert keine gespeicherten Daten. In 'Parameters[].Name' steht Parameters[] für die zurückgegebenen Datensätze und .Name wählt ihre Namen aus. Lasse den Ausdruck in einfachen Anführungszeichen.

Füge diese Auswahl zu deinem vorhandenen Filter hinzu:

aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ --query 'Parameters[].Name'

Die Antwort ist eine JSON-Liste mit drei Namen. Beachte, dass der Filter weiterhin die Ressourcen auswählt; die Abfrage wählt aus, welche Felder angezeigt werden.

Eine Feldauswahl zeigt Ressourcennamen an, während die vollständigen Datensätze unverändert bleiben

Konzeptdiagramm: Die Auswahl von Name blendet andere Felder in dieser Antwort aus; sie löscht sie nicht.

Für eine kompaktere Darstellung hänge --output table an:

aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ --query 'Parameters[].Name' --output table

Dieselben drei Namen erscheinen in einer Tabelle. Das Ausgabeformat verändert nur die Darstellung.

Lies die genaue Staging-Formateinstellung anhand ihres Namens:

aws ssm get-parameter --name /labex/inventory/finance/staging/report-format

Suche Value: Der Wert ist json. Dies ist das Exportformat der Anwendung, unabhängig vom JSON-Antwortformat der CLI. Der nachgelagerte Berichtsimport benötigt CSV, also aktualisiere diese Einstellung:

aws ssm put-parameter --name /labex/inventory/finance/staging/report-format --type String --value csv --overwrite

Lies sie erneut:

aws ssm get-parameter --name /labex/inventory/finance/staging/report-format

Ihr Wert ist jetzt csv. Vergleiche in AWS View Finance Staging mit Production und HR:

Nur das Exportformat von Finance Staging ändert sich auf csv

Beispielergebnis: Finance Staging verwendet csv; Production bleibt bei json und HR bei xlsx. Dein Prüfstatus ist weiterhin in-review.

Bestätige die Einstellungen und schließe die Prüfung ab

In diesem Schritt liest du die zwei geprüften Werte und kennzeichnest die Finance-Staging-Konfiguration als bereit.

Du kannst auch ein Feld einer einzelnen Ressource auswählen. 'Parameter.Value' liest den Wert innerhalb von Parameter; --output text zeigt ihn ohne JSON-Anführungszeichen an:

aws ssm get-parameter --name /labex/inventory/finance/staging/report-format --query 'Parameter.Value' --output text

Die Antwort lautet csv. Bestätige, wem diese Berichtskonfiguration gehört:

aws ssm get-parameter --name /labex/inventory/finance/staging/report-owner --query 'Parameter.Value' --output text

Die Antwort lautet finance. Dies sind gespeicherte Werte; die frühere Metadatenliste zeigte stattdessen Namen und Beschreibungen.

Kennzeichne jetzt die abgeschlossene Prüfung als bereit:

aws ssm put-parameter --name /labex/inventory/finance/staging/review-status --type String --value ready --overwrite

Lies dieses Ergebnis zurück:

aws ssm get-parameter --name /labex/inventory/finance/staging/review-status --query 'Parameter.Value' --output text

Die Antwort lautet ready. AWS View zeigt Finance Staging mit Format csv, Eigentümer finance und Status ready. Du hast Einstellungen geprüft und keine Berichtsanwendung bereitgestellt.

Entferne den ausgewählten Namensraum

In diesem Schritt löschst du nur die Finance-Staging-Ressourcen, nachdem die Prüfungen der Konfiguration bestanden sind.

Eine CLI-Abfrage formt nur eine Antwort; sie ist keine dauerhafte Schutzmaßnahme für eine spätere Löschung. Halte den Bereinigungsumfang ausdrücklich fest. delete-parameters akzeptiert mit --names eine Liste genauer Namen; dies sind die drei Ressourcen dieser Übung:

aws ssm delete-parameters --names /labex/inventory/finance/staging/report-format /labex/inventory/finance/staging/report-owner /labex/inventory/finance/staging/review-status

DeletedParameters in der Antwort listet die entfernten Namen auf; InvalidParameters sollte leer sein. Prüfe das Staging-Präfix mit einer erfolgreichen Dienstanfrage:

aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ --query 'Parameters[].Name' --output json

Das Ergebnis lautet []. Ein Verbindungs- oder Authentifizierungsfehler ist eine fehlgeschlagene Beobachtung und kein Beleg für eine Löschung.

Lies die Namen des verbleibenden Inventars:

aws ssm describe-parameters --query 'Parameters[].Name' --output table

Drei Ressourcen bleiben übrig: Format und Prüfstatus von Finance Production sowie das Format von HR Staging. Prüfe ihre Werte, ohne sie zu verändern:

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

Die Werte bleiben json, ready und xlsx. AWS View zeigt Finance Staging als No parameters, während die anderen Gruppen weiterhin Einträge enthalten. Die unabhängige Bereinigungsprüfung kontrolliert auch, dass ihre ursprünglichen Versionen und Beschreibungen erhalten bleiben.

Zusammenfassung

Du hast Finance Staging mit einem Namenspräfixfilter gefunden, Namen oder einen einzelnen Wert mit --query ausgewählt und die Lesbarkeit mit Tabellen- oder Textausgabe verbessert. Du hast nur die zugewiesene Konfiguration aktualisiert und sie anschließend entfernt, während die Ressourcen anderer Teams erhalten blieben.

Als Nächstes ergänzt „Ressourcen mit Tags organisieren“ Team- und Umgebungskennzeichnungen, damit sich Ressourcen auch bei unterschiedlichen Namensmustern gruppieren lassen.