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

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

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

类型: Boolean

:必需 否

DesiredState

预期状态。如果设置为running,则此操作将等待 Amazon EC2 状态Running,实例状态为OK,系统状态为OK,然后再完成。

类型: 字符串

有效值:running | stopped | terminated

:必需 是

Force

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

类型: Boolean

:必需 否

AdditionalInfo

预留。

类型: 字符串

:必需 否

Output