Wie füge ich Parameter hinzu, wenn ich eine Automatisierungsaufgabe in den Wartungsfenstern des Systems Managers registriere?

Kurzbeschreibung

Wenn du eine Automatisierungsaufgabe für ein Wartungsfenster registrierst, musst du Eingabeparameterwerte angeben, die an die Aufgabe übergeben werden, wenn diese ausgeführt wird. Die erforderlichen Eingabeparameter sind dieselben wie die Parameter, die im Inhalt des Automatisierungsdokuments definiert sind. Du kannst Pseudoparameterwerte in den erforderlichen Eingabeparameterfeldern verwenden, um dynamisch auf die Ressourcen-IDs zu verweisen, auf die das Wartungsfenster abzielt. Mit Pseudoparametern wie {{RESOURCE_ID}} kannst du mehrere Ressourcen als Ziel auswählen, sodass du nicht jede Ressourcen-ID einzeln eingeben musst.

Für das von Amazon bereitgestellte AWS-StopEC2Instance-Dokument musst du beispielsweise die Instance-ID als Parameter eingeben. Verwende einen Pseudoparameter, damit das Wartungsfenster auf mehrere Instances abzielt, oder wenn du die Instance-ID nicht kennst.

Hinweis: Für den Zieltyp INSTANCE stellen die Pseudoparameter {{TARGET_ID}} und {{RESOURCE_ID}} nur die Instance-ID bereit. Für den Zieltyp RESOURCE_GROUP geben {{TARGET_ID}} und {{RESOURCE_ID}} die ID jedoch in unterschiedlichen Formaten zurück. Weitere Informationen und eine Liste der verfügbaren Pseudoparameter findest du unter Verwendung von Pseudoparametern bei der Registrierung von Wartungsfensteraufgaben.

Lösung

Du kannst entweder die Systems Manager-Konsole oder die AWS Command Line Interface (AWS CLI) verwenden, um Automatisierungsaufgaben für Wartungsfenster mit Pseudoparametern zu registrieren.

Verwendung der Systems-Manager-Konsole

Führe die folgenden Schritte aus:

1. Öffne die Systems-Manager-Konsole.
2. Wähle im Navigationsbereich Wartungsfenster aus, und wähle dann dein Wartungsfenster aus.
3. Wähle auf der Seite Aufgaben die Option Aufgaben registrieren und dann Automatisierungsaufgabe registrieren.
4. Gib auf der Seite Automatisierungsaufgabe registrieren die folgenden Informationen ein:
   Wähle unter Automatisierungsdokument das Dokument aus, das die Aufgabe ausführen soll.
   Gib für Ziele deine Zielinformationen an.
   Gib für Eingabeparameter einen Pseudoparameterwert ein. Gib beispielsweise TARGET_ID oder RESOURCE_ID für den Parameter ein, der eine Ressourcen-ID erfordert.
   Gib für Ratensteuerung deine Preisinformationen an.
   Wähle für die IAM-Servicerolle eine AWS Identity and Access Management (IAM, Identitäts- und Zugriffsmanagement)-Rolle aus.
5. Wähle Automatisierungsaufgabe registrieren aus.

Verwendung der AWS CLI

Hinweis: Wenn du beim Ausführen von AWS CLI-Befehlen Fehlermeldungen erhältst, findest du weitere Informationen dazu unter Problembehandlung bei der AWS CLI. Stelle außerdem sicher, dass du die neueste Version der AWS CLI verwendest.

Führe den Befehl register-task-with-maintenance-window aus.

Der folgende Beispielbefehl registriert eine Automatisierungsaufgabe, die den Parameter {{RESOURCE_ID}} enthält:

aws ssm register-task-with-maintenance-window --window-id mw-1234567890EXAMPLE --targets Key=WindowTargetIds,Values=6c226ea3-463a-4533-8a2d-EXAMPLE --task-arn AWS-StopEC2Instance --task-type AUTOMATION --name MyMaintenanceWindowTask --max-concurrency 10 --max-errors 5 --task-invocation-parameters={\"Automation\":{\"Parameters\":{\"InstanceId\":[\"{{RESOURCE_ID}}\"]}}} --service-role-arn YOUR_SERVICE_ROLE_ARN

Wenn die Aufgabe im Wartungsfenster ausgeführt wird, wird die Ressourcen-ID für jedes Ziel an das System weitergegeben. Im vorherigen Beispiel erhält der Parameter InstanceId die Instance-ID für jedes Ziel in der Zielgruppe.

Ähnliche Informationen

Unterstützte Pseudoparameter

Parameteroptionen für den Befehl register-task-with-maintenance-windows