aws:waitForAwsResourceProperty: aguarde uma propriedade de recurso da AWS

A ação aws:waitForAwsResourceProperty permite que a automação espere por um estado específico do recurso ou um estado do evento antes de continuar a automação. Para obter mais exemplos de como usar essa ação, consulte Exemplos adicionais de runbook.

nota

O valor de tempo limite padrão para esta ação é 3600 segundos (uma hora). Você pode limitar ou prolongar o tempo limite especificando o parâmetro timeoutSeconds para uma etapa aws:waitForAwsResourceProperty. Para obter mais informações e exemplos de como usar essa ação, consulte Gerenciar tempos limite em runbooks.

Entrada

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

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

Serviço

O namespace do Serviço da AWS que contém a operação de API que você deseja executar. Por exemplo, o namespace para AWS Systems Manager é ssm. O namespace do Amazon Elastic Compute Cloud (Amazon EC2) é ec2. Você pode visualizar uma lista de namespaces de 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).

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.

Tipo: MapList, StringList

Obrigatório: Sim