aws:changeInstanceState – Instance-Status ändern oder geltend machen - AWS Systems Manager

AWS Systems ManagerChange Managersteht neuen Kunden nicht mehr offen. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der AWS Systems ManagerChange Manager Verfügbarkeit.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

aws:changeInstanceState – Instance-Status ändern oder geltend machen

Ändert oder klärt den Status der Instance.

Diese Aktivität kann im Assert-Modus verwendet werden (führt jedoch die API nicht aus, um den Status zu ändern, sondern prüft, ob die Instance den gewünschten Status aufweist.) Um den Assert-Modus zu verwenden, setzen Sie den Parameter CheckStateOnly auf "true". Dieser Modus ist nützlich, wenn der Sysprep-Befehl unter Windows Server ausgeführt wird. Bei diesem Befehl handelt es sich um einen asynchronen Befehl, der lange Zeit im Hintergrund ausgeführt werden kann. Sie können sicherstellen, dass die Instance angehalten wird, bevor Sie ein Amazon Machine Image (AMI) erstellen.

Anmerkung

Der Standardwert für die Zeitüberschreitung für diese Aktion beträgt 3 600 Sekunden (eine Stunde). Sie können die Zeitüberschreitung über den Parameter timeoutSeconds für einen aws:changeInstanceState-Schritt anpassen.

Anmerkung

Die Aktion aws:changeInstanceState unterstützt die automatische Drosselungswiederholung. Weitere Informationen finden Sie unter Konfigurieren der automatischen Wiederholung für gedrosselte Vorgänge.

Eingabe

YAML
name: stopMyInstance
action: aws:changeInstanceState
maxAttempts: 3
timeoutSeconds: 3600
onFailure: Abort
inputs:
  InstanceIds:
  - i-1234567890abcdef0
  CheckStateOnly: true
  DesiredState: stopped
JSON
{
    "name":"stopMyInstance",
    "action": "aws:changeInstanceState",
    "maxAttempts": 3,
    "timeoutSeconds": 3600,
    "onFailure": "Abort",
    "inputs": {
        "InstanceIds": ["i-1234567890abcdef0"],
        "CheckStateOnly": true,
        "DesiredState": "stopped"
    }
}
InstanceIds

Die IDs der Instanzen.

Typ: StringList

Erforderlich: Ja

CheckStateOnly

Wenn „false“, wird der Instance-Status auf den gewünschten Status festgelegt. Wenn „true“, wird der gewünschte Status anhand einer Abfrage überprüft.

Standard: false

Typ: Boolesch

Erforderlich: Nein

DesiredState

Der gewünschte Status. Wenn diese Option auf gesetzt istrunning, wartet sie darauf, dass der EC2 Amazon-StatusRunning, der Instance-Status und der Systemstatus erreicht sindOK, OK bevor sie abgeschlossen wird.

Typ: Zeichenfolge

Zulässige Werte: running | stopped | terminated

Erforderlich: Ja

Force

Wenn festgelegt, wird das Anhalten der Instances erzwungen. Die Instances haben keine Gelegenheit, die Caches oder Metadaten des Dateisystems zu leeren. Wenn Sie diese Option verwenden, müssen Sie eine Überprüfung und Reparatur des Dateisystems durchführen. Diese Option wird nicht für EC2 Instances für Windows Server empfohlen.

Typ: Boolesch

Erforderlich: Nein

AdditionalInfo

Reserved Instances.

Typ: Zeichenfolge

Erforderlich: Nein

Output

Keine