aws:waitForAwsResourceProperty – 在 AWS 資源屬性上等待

aws:waitForAwsResourceProperty 動作可讓您的自動化在繼續自動化之前等待特定的資源狀態或事件狀態。如需有關如何使用此動作的更多範例，請參閱 其他執行手冊範例。

注意

此動作的預設逾時值為 3600 秒 (1 小時)。您可以透過指定 aws:waitForAwsResourceProperty 步驟的 timeoutSeconds 參數來限制或延長逾時。如需使用此動作的詳細資訊和範例，請參閱 處理 Runbook 中的逾時。

Input

輸入是由您選擇的 API 操作定義。

YAML

action: aws:waitForAwsResourceProperty
inputs:
  Service: The official namespace of the service
  Api: The API operation or method name
  API operation inputs or parameters: A value
  PropertySelector: Response object
  DesiredValues:
  - Desired property value

JSON

{
  "action": "aws:waitForAwsResourceProperty",
  "inputs": {
    "Service":"The official namespace of the service",
    "Api":"The API operation or method name",
    "API operation inputs or parameters":"A value",
    "PropertySelector": "Response object",
    "DesiredValues": [
      "Desired property value"
    ]
  }
}

服務

AWS 服務 命名空間包含了您想要執行的 API 操作。例如，AWS Systems Manager 的命名空間為 ssm。Amazon Elastic Compute Cloud (Amazon EC2) 的命名空間為 ec2。您可以檢視AWS CLI命令參考可用服務章節中的受支援 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 operation 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 operation 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 列為回應物件。

類型：字串

必要：是

DesiredValues

讓自動化繼續的預期狀態。

類型：MapList、StringList

必要：是