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

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

aws:waitForAwsResourceProperty 動作可讓您的自動化在繼續自動化之前等待特定的資源狀態或事件狀態。如需使用此動作的詳細資訊和範例,請參閱 從 Systems Manager Automation Runbook 叫用其他 AWS 服務

注意

此動作的預設逾時值為 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 方法並向下捲動以查看可用的參數,例如 DBInstanceIdentifierNameValues

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 列為回應物件。

類型:整數、布林值、字串、StringList、StringMap 或 MapList

必要:是

DesiredValues

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

類型:Varies

必要:是