A ação Descrever instância recupera os detalhes das instâncias EC2 que estão em execução atualmente na região especificada na ação Conectar. A ação recupera detalhes como o estado da instância, status do sistema, zona de disponibilidade, etc.

A ação Descrever instância usa o nome da sessão especificado na ação Conectar para autenticar a solicitação de recuperação no URL base. Essa ação permite a recuperação de detalhes de uma, várias ou todas as instâncias.

A seção Filtros permite a definição de critérios para recuperar detalhes de instâncias específicas. Para mais informações sobre os filtros disponíveis, consulte a seção Filtros em DescribeInstances.

Configurações

As seguintes configurações estão disponíveis na ação Descrever instância:

Nome da sessão
O identificador da sessão definido na ação Conectar. O sistema atribui automaticamente Padrão como o nome da sessão. Você pode fornecer uma variável de string ou usar uma variável de sessão.
IDs da instância
Os IDs das instâncias EC2 a serem iniciadas. Para várias instâncias, adicione os IDs das instâncias como valores separados por vírgula. Para todas as instâncias, deixe o campo em branco.
Filtros
Os Filtros definem os critérios para recuperar detalhes de instâncias EC2 específicas. O botão Adicionar filtro permite a definição de nomes e valores de filtro. A ação recupera os detalhes das instâncias que atendem aos critérios do filtro.
O sistema executa a operação lógica AND para filtros com nomes diferentes e executa a operação lógica OR para filtros com o mesmo nome e valores diferentes. Os exemplos a seguir ilustram como a opção Filtros funciona:
Para recuperar os detalhes de todas as instâncias EC2 nas VPCs vpc-01234 e vpc-56789, defina o filtro da seguinte forma:
Nome do filtro Valor do filtro
vpc-id vpc-01234
vpc-id vpc-56789
Para recuperar os detalhes das instâncias EC2 do tipo c5.2xlarge que estão em execução, defina o filtro da seguinte forma:
Nome do filtro Valor do filtro
instance-type c5.2xlarge
instance-state-name 24 horas por dia,
Atribuir detalhes da instância à variável
Variáveis que armazenam os IDs, informações do estado atual e anterior de cada instância EC2. As seguintes opções estão disponíveis:
  • Variáveis múltiplas: Variáveis individuais com chaves, cada uma contendo um detalhe específico da instância.
  • Dicionário: Uma única variável de dicionário que contém todos os detalhes da instância.