• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# `aws:assertAwsResourceProperty`: define um estado do recurso da AWS ou o estado do evento
<a name="automation-action-assertAwsResourceProperty"></a>

A ação `aws:assertAwsResourceProperty` permite que você declare um estado de recurso específico ou estado de evento para uma determinada etapa do Automation.

**nota**  
A ação `aws:assertAwsResourceProperty` suporta uma nova tentativa automática de controle de utilização. Para obter mais informações, consulte [Configurar a repetição automática para operações com controle de utilização](automation-throttling-retry.md).

Para obter mais exemplos de como usar essa ação, consulte [Exemplos adicionais de runbook](automation-document-examples.md).

**Input**  
As entradas são definidas pela operação de API que você escolher. 

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

------

Serviço  
O namespace do AWS service (Serviço da AWS) que contém a operação de API que você deseja executar. Por exemplo, o namespace para o Systems Manager é `ssm`. O namespace do Amazon EC2 é `ec2`. Você pode visualizar uma lista de namespaces de AWS service (Serviço da AWS) compatíveis na seção [Available Services](https://docs.aws.amazon.com/cli/latest/reference/#available-services) (Serviços disponíveis) da *Referência de comandos da AWS CLI*.  
Tipo: String  
Exigido: sim

API  
O nome da operação de API que você deseja executar. Você pode visualizar as operações de API (também chamadas de métodos), escolhendo um serviço na navegação à esquerda na seguinte página de [Referência de serviços](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html): Escolha um método na seção **Client (Cliente)** para o serviço que você deseja invocar. Por exemplo, todas as operações de API (métodos) do Amazon Relational Database Service (Amazon RDS) estão listadas na seguinte página: [Amazon RDS methods](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html) (Métodos do Amazon RDS).  
Tipo: String  
Exigido: sim

Entradas de operação da API  
Uma ou mais entradas de operação da API. Você pode visualizar as entradas disponíveis (também chamadas de parâmetros), escolhendo um serviço na navegação à esquerda na seguinte página de [Referência de serviços](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html). Escolha um método na seção **Client (Cliente)** para o serviço que você deseja invocar. Por exemplo, todos os métodos de API estão listados na página a seguir: [Métodos do Amazon RDS](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html). Escolha o método [describe\_db\_instances](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html#RDS.Client.describe_db_instances) e role para baixo para ver os parâmetros disponíveis, como **DBInstanceIdentifier**, **Name (Nome)** e **Values (Valores)**. Use o formato a seguir para especificar mais de uma entrada.  

```
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}}"
}
```
Tipo: determinado pela ação de API escolhida  
Obrigatório: Sim

PropertySelector  
O JSONPath para um determinado atributo no objeto de resposta. Você pode visualizar os objetos de resposta escolhendo um serviço na navegação à esquerda na seguinte página de [Referência de serviços](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/index.html). Escolha um método na seção **Client (Cliente)** para o serviço que você deseja invocar. Por exemplo, todos os métodos de API estão listados na página a seguir: [Métodos do Amazon RDS](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html). Escolha o método [describe\_db\_instances](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html#RDS.Client.describe_db_instances) e role para baixo até a seção **Response Structure (Estrutura de resposta)**. **DBInstances** é listado como um objeto de resposta.  
Tipo: String  
Exigido: sim

DesiredValues  
O status ou estado esperado no qual a automação deve continuar. Se você especificar um valor booleano, você deve usar uma letra maiúscula, como Verdadeiro ou Falso.  
Tipo: StringList  
Obrigatório: Sim