

• AWS Systems Manager CloudWatch ダッシュボードは、2026 年 4 月 30 日以降は利用できなくなります。お客様は、これまでと同様に Amazon CloudWatch コンソールを使用して、Amazon CloudWatch ダッシュボードの表示、作成、管理を継続できます。詳細については、「[Amazon CloudWatch ダッシュボードのドキュメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)」を参照してください。

# `aws:assertAwsResourceProperty` – AWS リソースの状態またはイベントの状態をアサートする
<a name="automation-action-assertAwsResourceProperty"></a>

`aws:assertAwsResourceProperty` アクションを使用すると、特定の Automation ステップの、特定のリソース状態またはイベント状態をアサートできます。

**注記**  
`aws:assertAwsResourceProperty` アクションは、自動スロットリング再試行をサポートしています。詳細については、「[スロットリングされたオペレーションの自動再試行の設定](automation-throttling-retry.md)」を参照してください。

このアクションの使用例については、「[その他のランブックの例](automation-document-examples.md)」を参照してください。

**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}}"
    ]
  }
}
```

------

サービス  
実行する API オペレーションを含む AWS のサービスの名前空間。例えば、Systems Manager の名前空間は `ssm` です。Amazon EC2 の名前空間は `ec2` です。サポートされている AWS のサービスの名前空間のリストは、 AWS CLI コマンドリファレンスの「[Available Services (利用可能なサービス)](https://docs.aws.amazon.com/cli/latest/reference/#available-services)」セクションを参照してください。  
タイプ: 文字列  
必須: はい

Api  
実行する API オペレーションの名前。API オペレーション (メソッド) は、以下の「[サービスリファレンス](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html)」ページの左側のナビゲーションでサービスを選択することで表示できます。呼び出すサービスの [**Client (クライアント)**] セクションでメソッドを選択します。例えば、Amazon Relational Database Service (Amazon RDS) のすべての API オペレーション (メソッド) は、[Amazon RDS メソッド](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html)のページに一覧表示されます。  
型: 文字列  
必須: はい

API オペレーション入力  
1 つ以上の API オペレーションを入力します。使用できる入力 (パラメータ) は、以下の「[サービスリファレンス](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html)」ページの左側のナビゲーションでサービスを選択することで表示できます。呼び出すサービスの [**Client (クライアント)**] セクションでメソッドを選択します。例えば、Amazon RDS のすべてのメソッドは、[Amazon RDS メソッド](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html)ページに一覧表示されています。[describe\_db\_instances](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html#RDS.Client.describe_db_instances) メソッドを選択し、下にスクロールして、[**DBInstanceIdentifier**]、[**Name (名前)**]、および [**Values (値)**] などの使用可能なパラメータを表示します。複数の入力を指定するには、次の形式を使用します。  

```
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}}
```

```
"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。レスポンスオブジェクトは、以下の「[サービスリファレンス](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html)」ページの左側のナビゲーションでサービスを選択することで表示できます。呼び出すサービスの [**Client (クライアント)**] セクションでメソッドを選択します。例えば、Amazon RDS のすべてのメソッドは、[Amazon RDS メソッド](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html)ページに一覧表示されています。[describe\_db\_instances](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html#RDS.Client.describe_db_instances) メソッドを選択し、[**Response Structure (レスポンス構造)**] セクションまで下にスクロールします。[**DBInstances**] は応答オブジェクトとして表示されます。  
型: 文字列  
必須: はい

DesiredValues  
予定の状態、またはオートメーションを継続する状態。ブール値を指定する場合は、True または False などのように大文字を使用する必要があります。  
タイプ: StringList  
必須: はい