aws:changeInstanceState – 變更或宣告執行個體狀態

變更或宣告執行個體的狀態。

此動作可用於宣告模式 (不執行 API 以變更狀態，但會驗證執行個體處於所需的狀態)。若要使用宣告模式，請將 CheckStateOnly 參數設定為 true。此模式可用於在 Windows 上執行 Sysprep 命令，這是一種非同步命令，可在背景長時間執行。您可以確保執行個體在您建立 Amazon Machine Image (AMI) 之前停止。

注意

此動作的預設逾時值為 3600 秒 (1 小時)。您可以透過指定 aws:changeInstanceState 步驟的 timeoutSeconds 參數來限制或延長逾時。

輸入

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

執行個體的 ID。

類型：StringList

必要：是

CheckStateOnly

如果為 false，則會將執行個體狀態設為所需的狀態。如果為 true，則會使用輪詢宣告所需的狀態。

預設：false

類型：布林值

必要：否

DesiredState

所需的狀態。設為 running 時，則在完成之前，此動作會等待 Amazon EC2 狀態成為 Running，執行個體狀態成為 OK，系統狀態成為 OK。

類型：字串

有效值：running | stopped | terminated

必要：是

Force

如果設定，則會強制執行個體停止。執行個體沒有機會排清檔案系統快取或檔案系統中繼資料。如果使用此選項，您必須執行檔案系統檢查及修復程序。此選項不建議用於 Windows Server 的 EC2 執行個體。

類型：布林值

必要：否

AdditionalInfo

預訂.

類型：字串

必要：否

輸出

無