EC2 Instance Info

14 min

Resumo

Obtenha informações sobre instâncias ec2 na AWS.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
filters	dictionary	- {} (default)	Uma lista de filtros a serem aplicados. Cada item dict consiste em uma chave de filtro e um valor de filtro. Consulte https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html para obter os filtros possíveis. Os nomes e valores dos filtros diferenciam maiúsculas de minúsculas.
instance_ids	list / elements=string		Se você especificar um ou mais IDs de instância, apenas as instâncias que possuem os IDs especificados são retornadas.

Extende fragmentos da documentação do módulo ec2.

Exemplos

# Exemplo: Obter as instâncias EC2
- ec2_instance_info:
    aws_access_key: access_key
    aws_secret_key: secret_key
    region: us-east-1

Valores retornados

Chave	Tipo	Retornado quando	Descrição
instances (Possíveis valores)	complex	Sempre	Uma lista de instâncias ec2.

Subcampos da chave de retorno instances

Chave	Tipo	Retornado quando	Descrição
ami_launch_index	integer	Sempre	O índice de lançamento AMI, que pode ser usado para localizar essa instância no grupo de lançamento.
architecture	string	Sempre	A arquitetura da imagem.
block_device_mappings (Possíveis valores)	complex	Sempre	Quaisquer entradas de mapeamento de dispositivo de bloco para a instância.
client_token	string	Sempre	O token de idempotência que você forneceu ao iniciar a instância, se aplicável.
cpu_options (Possíveis valores)	complex	Sempre	As opções de CPU definidas para a instância.
ebs_optimized	boolean	Sempre	Indica se a instância está otimizada para I/O do EBS.
hypervisor	string	Sempre	O tipo de hipervisor da instância.
iam_instance_profile (Possíveis valores)	complex	Sempre	O perfil da instância IAM associado à instância, se aplicável.
image_id	string	Sempre	O ID do AMI usado para iniciar a instância.
instance_id	string	Sempre	O ID da instância.
instance_type	string	Sempre	O tipo da instância em execução.
key_name	string	Sempre	O nome do par de chaves, se esta instância foi iniciada com um par de chaves associado.
launch_time	string	Sempre	A hora em que a instância foi iniciada.
monitoring (Possíveis valores)	complex	Sempre	O monitoramento da instância.
network_interfaces (Possíveis valores)	complex	Sempre	Uma ou mais interfaces de rede para a instância.
placement (Possíveis valores)	complex	Sempre	O local onde a instância foi iniciada, se aplicável.
private_dns_name	string	Sempre	O nome DNS privado.
private_ip_address	string	Sempre	O endereço IPv4 da interface de rede na sub-rede.
product_codes (Possíveis valores)	list / elements=dictionary	Sempre	Um ou mais códigos de produto.
public_dns_name	string	Sempre	O nome DNS público atribuído à instância.
public_ip_address	string	Sempre	O endereço IPv4 público atribuído à instância.
root_device_name	string	Sempre	O nome do dispositivo do dispositivo raiz.
root_device_type	string	Sempre	O tipo de dispositivo raiz usado pela AMI.
security_groups (Possíveis valores)	list / elements=dictionary	Sempre	Um ou mais grupos de segurança para a instância.
source_dest_check	boolean	Sempre	Indica se a verificação de origem / destino está habilitada.
state (Possíveis valores)	complex	Sempre	O estado atual da instância.
state_transition_reason	string	Sempre	O motivo da transição de estado mais recente.
subnet_id	string	Sempre	O ID da sub-rede em que a instância está sendo executada.
tags	dictionary	Sempre	Quaisquer tags atribuídas à instância.
virtualization_type	string	Sempre	O tipo de virtualização da AMI.
vpc_id	dictionary	Sempre	O ID do VPC em que a instância está.

Subcampos da chave de retorno block device mappings

Chave	Tipo	Retornado quando	Descrição
device_name	string	Sempre	O nome do dispositivo exposto à instância (por exemplo, /dev/sdh ou xvdh).
ebs	complex	Sempre	Parâmetros usados para configurar volumes EBS automaticamente quando a instância é iniciada.
attach_time	string	Sempre	A hora em que o anexo foi iniciado.
delete_on_termination	boolean	Sempre	Indica se o volume é excluído no encerramento da instância.
status	string	Sempre	O status.
volume_id	string	Sempre	O ID do volume EBS.

Subcampos da chave de retorno cpu options

Chave	Tipo	Retornado quando	Descrição
core_count	integer	Sempre	O número de núcleos de CPU para a instância.
threads_per_core	integer	Sempre	O número de threads por núcleo da CPU. Na instância com suporte, um valor de 1 significa que a tecnologia Intel Hyper-Threading está desativada.

Subcampos da chave de retorno iam instance profile

Chave	Tipo	Retornado quando	Descrição
arn	string	Sempre	O Amazon Resource Name (ARN) do perfil da instância.
id	string	Sempre	O ID do perfil da instância.

Subcampos da chave de retorno monitoring

Chave	Tipo	Retornado quando	Descrição
state	string	Sempre	Indica se o monitoramento detalhado está habilitado. Caso contrário, o monitoramento básico é habilitado.

Subcampos da chave de retorno network_interfaces

Chave	Tipo	Retornado quando	Descrição
association subopções: ip_owner_id public_dns_name public_ip	complex string string string	Sempre Sempre Sempre Sempre	As informações de associação para um Elastic IPv4 associado à interface de rede. A ID do proprietário do endereço Elastic IP. O nome DNS público. O endereço IP público ou endereço IP elástico vinculado à interface de rede.
attachment subopções: attach_time attachment_id delete_on_termination device_index status	complex string string boolean integer string	Sempre Sempre Sempre Sempre Sempre Sempre	O anexo da interface de rede. A hora em que o anexo foi iniciado. O ID do anexo da interface de rede. Indica se a interface de rede é excluída quando a instância é encerrada. O índice do dispositivo na instância para o anexo da interface de rede. O status.
description	string	Sempre	A descrição.
groups subopções: group_id group_name	list / elements=dictionary string string	Sempre Sempre Sempre	Um ou mais grupos de segurança. O ID do grupo de segurança. O nome do grupo de segurança.
ipv6_addresses subopções: ipv6_address	list / elements=dictionary string	Sempre Sempre	One or more IPv6 addresses associated with the network interface. The IPv6 address.
mac_address	string	Sempre	O endereço MAC.
network_interface_id	string	Sempre	O ID da interface de rede.
owner_id	string	Sempre	O ID da conta AWS do proprietário da interface de rede.
private_ip_address	string	Sempre	O endereço IPv4 da interface de rede na sub-rede.
private_ip_addresses	list / elements=dictionary	Sempre	Os endereços IPv4 privados associados à interface de rede.
source_dest_check	boolean	Sempre	Indica se a verificação de origem / destino está habilitada.
status	string	Sempre	O status da interface de rede.
subnet_id	string	Sempre	O ID da sub-rede para a interface de rede.
vpc_id	string	Sempre	O ID do VPC para a interface de rede.

Subcampos da chave de retorno placement

Chave	Tipo	Retornado quando	Descrição
availability_zone	string	Sempre	A zona de disponibilidade da instância.
group_name	string	Sempre	O nome do grupo de posicionamento em que a instância está (para instâncias de computação de cluster).
tenancy	string	Sempre	A locação da instância (se a instância estiver em execução em um VPC).

Subcampos da chave de retorno product_codes

Chave	Tipo	Retornado quando	Descrição
product_code_id	string	Sempre	O código do produto.
product_code_type	string	Sempre	O tipo de código do produto.

Subcampos da chave de retorno security_groups

Chave	Tipo	Retornado quando	Descrição
group_id	string	Sempre	O ID do grupo de segurança.
group_name	string	Sempre	O nome do grupo de segurança.

Subcampos da chave de retorno state

Chave	Tipo	Retornado quando	Descrição
code	integer	Sempre	O byte baixo representa o estado.
name	string	Sempre	O nome do estado.