aws:assertAwsResourceProperty: define um estado do recurso da AWS ou o estado do evento

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. Por exemplo, você pode especificar que uma etapa do Automation deve esperar que uma instância do Amazon Elastic Compute Cloud (Amazon EC2) seja iniciada. Em seguida, ele chamará a operação da API DescribeInstanceStatus do Amazon EC2 com a propriedade DesiredValue do running. Isso garante que a automação aguarde por uma instância em execução e continue quando a instância estiver, de fato, em execução.

Para obter mais exemplos de como usar essa ação, consulte Exemplos adicionais de runbook.

Entrada

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 (Serviços disponíveis) da Referência de comandos da AWS CLI.

Tipo: sequência

Obrigatório: 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: 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 (Métodos do Amazon RDS).

Tipo: sequência

Obrigatório: 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. 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. Escolha o método 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.

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

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. 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. Escolha o método describe_db_instances e role para baixo até a seção Response Structure (Estrutura de resposta). DBInstances é listado como um objeto de resposta.

Tipo: sequência

Obrigatório: 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