aws:assertAwsResourceProperty – 宣告 AWS 資源狀態或事件狀態 - AWS Systems Manager

aws:assertAwsResourceProperty – 宣告 AWS 資源狀態或事件狀態

aws:assertAwsResourceProperty 動作可讓您針對特定自動化步驟宣告特定的資源狀態或事件狀態。例如,您可以指定 Automation 步驟必須等待 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體啟動。然後,它會使用 running DesiredValue 屬性呼叫 Amazon EC2 DescribeInstanceStatus API 操作。這可確保自動化等待執行中的執行個體,接著在執行個體實際執行時繼續。

如需使用此動作的詳細資訊和範例,請參閱 從 Systems Manager Automation Runbook 叫用其他 AWS 服務

Input

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

YAML
action: aws:assertAwsResourceProperty 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 values
JSON
{ "action": "aws:assertAwsResourceProperty", "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 values" ] } }
服務

AWS 服務命名空間包含了您想要執行的 API 操作。例如,Systems Manager 的命名空間為 ssm。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 列為回應物件。

類型:字串

必要:是

DesiredValues

讓自動化繼續的預期狀態。如果指定布林值,您必須使用大寫字母,例如 True 或 False。

類型:StringList

必要:是