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

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

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

Required: No

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

Required: No

AdditionalInfo

Reserved Instances.

Typ: Zeichenfolge

Required: No

Ausgabe

Keine