aws:changeInstanceState – Change or assert instance state - AWS Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

如果我们为英文版本指南提供翻译,那么如果存在任何冲突,将以英文版本指南为准。在提供翻译时使用机器翻译。

aws:changeInstanceState – Change or assert instance state

更改或断言实例的状态。

此操作可以在“AssertMode”中使用(请勿运行API以更改状态,但验证实例处于所需状态。)要使用“AssertMode”,设置 CheckStateOnly 参数为true。当在 Windows 上运行 Sysprep 命令时,此模式很有用。该命令是一种可在后台长时间运行的异步命令。您可以确保在创建 AMI 之前停止实例。

注意

此操作的默认超时值为 3600 秒(1 小时)。您可以通过指定 aws:changeInstanceState 步骤的 timeoutSeconds 参数来限制或延长超时。

Input

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。

Type StringList

必填 是

CheckStateOnly

如果为 false,请将实例状态设置为预期状态。如果为 true,请使用轮询断言预期状态。

默认值:false

Type 布尔型

必填 否

DesiredState

预期状态。设置为 running 时,此操作在完成之前等待 Amazon EC2 状态变为 Running、实例状态变为 OK、系统状态变为 OK

Type :字符串

有效值:{、} running || stopped || terminated

必填 是

Force

如果设置此项,则强制停止实例。则该实例没有机会来刷新文件系统缓存或文件系统元数据。如果您使用此选项,则必须执行文件系统检查和修复流程。我们不建议将该选项用于 Windows Server 的 EC2 实例。

Type 布尔型

必填 否

AdditionalInfo

(预留)

Type :字符串

必填 否

输出。