aws:changeInstanceState – 更改或声明实例状态 - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

预留。

类型：字符串

必需：否

输出

无