本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
aws:assertAwsResourceProperty – 声明 AWS 资源状态或事件状态
操作使您能够对特定 Automation 步骤的特定资源状态或事件状态进行断言。aws:assertAwsResourceProperty
例如,您可以指定某个 Automation 步骤必须等待 EC2 实例启动。然后,它将使用 DesiredValue 属性 Amazon EC2 调用 DescribeInstanceStatus API 操作。running
这可确保自动化等待一个正在运行的实例,然后在实例实际上正在运行时继续。
有关如何使用此操作的更多信息和示例,请参阅从 AWS Automation 运行手册调用其他 Systems Manager 服务.
此操作的默认超时值为 3600 秒(1 小时)。您可以通过指定 timeoutSeconds
步骤的 aws:assertAwsResourceProperty
参数来限制或延长超时。
Input
输入由您选择的 API 操作定义。
- 服务
-
包含要运行的 API 操作的 AWS 服务命名空间。例如,Systems Manager 的命名空间为
ssm
. Amazon EC2 的命名空间为ec2
. 您可以在 https://docs.amazonaws.cn/cli/latest/reference/#available-services 的 Available Services (可用服务)AWS CLI Command Reference 部分中查看支持的 AWS 服务命名空间的列表。类型:字符串
必需:是
- API
-
要运行的 API 操作的名称。您可以在以下服务参考
页面的左侧导航窗格中选择服务来查看 API 操作(也称为方法)。在要调用的服务的 Client (客户端) 部分中选择一种方法。例如,以下页面中列出了 Amazon Relational Database Service (Amazon RDS) 的所有 API 操作(方法):Amazon RDS 方法 . 类型:字符串
必需:是
- API 操作输入
-
一个或多个 API 操作输入。您可以在以下服务参考
页面的左侧导航窗格中选择服务来查看可用的输入(也称为参数)。在要调用的服务的 Client (客户端) 部分中选择一种方法。例如,Amazon RDS 方法页面中列出了 Amazon RDS 的所有方法。 选择 describe_db_instances 方法并向下滚动以查看可用的参数,例如 DBInstanceIdentifier、Name 和 Values. 使用以下格式指定多个输入。 类型:由选择的 API 操作确定
必需:是
- PropertySelector
-
响应对象中特定属性的 JSONPath。您可以在以下服务参考
页面的左侧导航窗格中选择服务来查看响应对象。在要调用的服务的 Client (客户端) 部分中选择一种方法。例如,Amazon RDS 方法页面中列出了 Amazon RDS 的所有方法。 选择 describe_db_instances 方法并向下滚动到 Response Structure 部分。DBInstances 被列为响应对象。 类型:Integer、Boolean、String、StringList、StringMap 或 MapList
必需:是
- DesiredValues
-
要在其上继续 Automation 的预期状态。如果指定布尔值,则必须使用大写字母,例如 True 或 False。
类型:可变
必需:是