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

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 Instances.

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. Bei der Einstellung running wartet diese Aktion auf den Amazon EC2 Status Running, den Instance-Status OK und den Systemstatus OK vor dem Abschluss.

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 für EC2-Instances für Windows Server nicht empfohlen.

Typ: Boolesch

Erforderlich: Nein

AdditionalInfo

Reserved Instances.

Typ: Zeichenfolge

Erforderlich: Nein

Output

Keine