aws:changeInstanceState – 更改或声明实例状态 - AWS Systems Manager

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

预留。

类型:字符串

必需:否

输出