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

Kurzbeschreibung

Wenn Sie eine Automatisierungsaufgabe für ein Wartungsfenster registrieren, müssen Sie 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. Sie können Pseudoparameterwerte in den erforderlichen Eingabeparameterfeldern verwenden, um dynamisch auf die Ressourcen-IDs zu verweisen, auf die das Wartungsfenster abzielt. Mit Pseudoparametern wie {{RESOURCE\ _ID}} können Sie mehrere Ressourcen als Ziel verwenden, ohne jede Ressourcen-ID einzeln eingeben zu müssen.

Für das von Amazon bereitgestellte AWS-StopEC2Instance-Dokument müssen Sie beispielsweise die Instance-ID als Parameter eingeben. Wenn das Wartungsfenster auf mehrere Instanzen abzielen soll oder wenn Sie die Instance-ID nicht kennen, ist die Verwendung eines Pseudoparameters angemessen.

Hinweis: Für den Zieltyp INSTANCE liefern sowohl die Pseudoparameter {{TARGET\ _ID}} als auch {{RESOURCE\ _ID}} nur die Instance-ID. Für den Zieltyp RESOURCE_GROUP geben {{TARGET_ID}} und {{RESOURCE_ID}} die ID jedoch in verschiedenen Formaten zurück. Weitere Informationen und eine Liste der verfügbaren Pseudoparameter finden Sie unter Über Pseudoparameter.

Sie können entweder die Systems Manager-Konsole oder das AWS Command Line Interface (AWS CLI) verwenden, um Automatisierungsaufgaben für Wartungsfenster mit Pseudoparametern zu registrieren.

Behebung

Verwendung der Konsole

So registrieren Sie eine Automatisierungsaufgabe für Wartungsfenster mithilfe dynamischer Pseudoparameter:

1. Öffnen Sie die Systems Manager-Konsole und wählen Sie dann im Navigationsbereich die Option** Maintenance Windows ** (Wartungsfenster) aus.
2. Wählen Sie Ihr Wartungsfenster und dann Details anzeigen aus.
3. Wählen Sie auf der Registerkarte Aufgaben die Option Aufgaben registrieren und Automatisierungsaufgabe registrieren aus.
4. Wählen Sie unter Automatisierungsdokument das Dokument aus, das die Aufgabe ausführen soll.
5. Geben Sie Ihre Ziele, Ratenkontrolle und IAM-Servicerolle an.
6. Geben Sie für Eingabeparameter einen Pseudo-Parameterwert (z. B. {{TARGET_ID}} oder {{RESOURCE_ID}}) für den Parameter ein, der eine Ressourcen-ID erfordert.
7. Wählen Sie Automatisierungsaufgabe registrieren aus.

Verwendung des AWS-CLI

Hinweis: Wenn Sie bei der Ausführung von AWS-CLI-Befehlen Fehlermeldungen erhalten, stellen Sie sicher, dass Sie die neueste Version des AWS CLI verwenden.

Im folgenden Beispiel wird die AWS-CLI für die Registrierung einer Automatisierungsaufgabe einschließlich des Parameters {{RESOURCE_ID}} verwendet:

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 entsprechende Ressourcen-ID für jedes Ziel an das System weitergegeben. Im vorherigen Beispiel erhält der InstanceID-Parameter die entsprechende Instance-ID für jedes Ziel in der Zielgruppe.

Weitere Informationen

Unterstützte Pseudoparameter

Informationen zu den Optionen zur Registrierung einer Aufgabe mit Wartungsfenstern