aws:assertAwsResourceProperty – 声明 AWS 资源状态或事件状态 - AWS Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

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

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 操作定义。

YAML
action: aws:assertAwsResourceProperty
inputs:
  Service: The official namespace of the service
  Api: The API action or method name
  API action inputs or parameters: A value
  PropertySelector: Response object
  DesiredValues:
  - Desired property values
JSON
{
  "action": "aws:assertAwsResourceProperty",
  "inputs": {
    "Service":"The official namespace of the service",
    "Api":"The API action or method name",
    "API action inputs or parameters":"A value",
    "PropertySelector": "Response object",
    "DesiredValues": [
      "Desired property values"
    ]
  }
}
服务

包含要运行的 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. 使用以下格式指定多个输入。

YAML
inputs:
  Service: The official namespace of the service
  Api: The API action name
  API input 1: A value
  API Input 2: A value
  API Input 3: A value
JSON
"inputs":{
      "Service":"The official namespace of the service",
      "Api":"The API action name",
      "API input 1":"A value",
      "API Input 2":"A value",
      "API Input 3":"A value"
}

类型：由选择的 API 操作确定

必需：是

PropertySelector

响应对象中特定属性的 JSONPath。您可以在以下服务参考页面的左侧导航窗格中选择服务来查看响应对象。在要调用的服务的 Client （客户端） 部分中选择一种方法。例如，Amazon RDS 方法页面中列出了 Amazon RDS 的所有方法。选择 describe_db_instances 方法并向下滚动到 Response Structure 部分。DBInstances 被列为响应对象。

类型：Integer、Boolean、String、StringList、StringMap 或 MapList

必需：是

DesiredValues

要在其上继续 Automation 的预期状态。如果指定布尔值，则必须使用大写字母，例如 True 或 False。

类型：可变

必需：是