Categorias de metadados da instância
Os metadados da instância são divididos em categorias. Para recuperar metadados de instância, especifique a categoria na solicitação. Os metadados serão retornados na resposta.
Quando novas categorias forem lançadas, uma nova compilação de metadados de instância será criada com um novo número de versão. Na tabela a seguir, a coluna Version when category was released (Versão quando a categoria foi lançada) especifica a versão da compilação quando uma categoria de metadados de instância foi lançada. Para evitar ter que atualizar seu código sempre que o Amazon EC2 lançar uma nova compilação de metadados de instância, use latest em vez do número da versão em suas solicitações de metadados. Para ter mais informações, consulte Obter as versões disponíveis dos metadados da instância.
Quando o Amazon EC2 libera uma nova categoria de metadados de instância, os metadados de instância da nova categoria podem não estar disponíveis para instâncias existentes. Com instâncias criadas no sistema Nitro, é possível recuperar metadados de instância somente para as categorias que estavam disponíveis ao iniciar. Para instâncias com o hipervisor Xen, é possível interromper e iniciar a instância para atualizar as categorias que estão disponíveis para a instância.
A tabela a seguir lista as categorias de metadados da instância. Alguns dos nomes de categoria incluem espaços reservados para dados exclusivos da instância. Por exemplo, mac representa o endereço MAC para a interface de rede. É necessário substituir os espaços reservados pelos valores reais ao recuperar os metadados da instância.
| Categoria | Descrição | Versão quando a categoria foi lançada |
|---|---|---|
ami-id
|
O ID da AMI usada para executar a instância. | 1,0 |
ami-launch-index
|
Se você executar várias instâncias usando a mesma chamada RunInstances, esse valor indicará a ordem de execução de cada instância. O valor da primeira instância executada é 0. Se você executar instâncias usando uma frota do Auto Scaling ou do EC2, esse valor será sempre 0. |
1,0 |
ami-manifest-path
|
O caminho para o arquivo de manifesto da AMI no Amazon S3. Se você usou uma AMI baseada no Amazon EBS para executar a instância, o resultado retornado será unknown. |
1,0 |
ancestor-ami-ids
|
Os IDs das AMIs de todas as instâncias que foram reagrupadas para criar essa AMI. Este valor existirá somente se o arquivo de manifesto de AMIs continham uma chave ancestor-amis. |
10/10/2007 |
autoscaling/target-lifecycle-state |
Valor mostrando o estado de destino do ciclo de vida do Auto Scaling para o qual uma instância do Auto Scaling está fazendo a transição. Presente quando a instância faz a transição para um dos estados de destino do ciclo de vida após 10 de março de 2022. Valores possíveis: |
2021-07-15 |
block-device-mapping/ami
|
O dispositivo virtual que contém o sistema de arquivos de inicialização/raiz. | 15/12/2007 |
block-device-mapping/ebsN |
Os dispositivos virtuais associados a quaisquer volumes do Amazon EBS. Os volumes do Amazon EBS estarão disponíveis somente em metadados se estiverem presentes no momento da execução ou quando a instância foi iniciada pela última vez. O N indica o índice do volume do Amazon EBS (como ebs1 ou ebs2). |
15/12/2007 |
block-device-mapping/ephemeralN |
Os dispositivos virtuais para qualquer volume de armazenamento de instâncias não NVMe. O N indica o índice de cada volume. O número dos volumes de armazenamento de instâncias no mapeamento de dispositivos de blocos pode não corresponder ao número real de volumes de armazenamento de instâncias da instância. O tipo de instância determina o número de volumes de armazenamento de instâncias que estão disponíveis para uma instância. Se o número de volumes de armazenamento de instâncias em um mapeamento de dispositivos de blocos exceder o número disponível para uma instância, os volumes de armazenamento de instâncias adicionais serão ignorados. | 15/12/2007 |
block-device-mapping/root
|
Os dispositivos virtuais ou as partições associadas aos dispositivos raiz, ou as partições no dispositivo virtual, onde o sistema de arquivos raiz (/ ou C:) está associado à instância específica. | 15/12/2007 |
block-device-mapping/swap
|
Os dispositivos virtuais associados a swap. Nem sempre presente. |
15/12/2007 |
elastic-gpus/associations/ |
Se houver um Elastic GPU anexado à instância, ele contém uma string JSON com informações sobre o Elastic GPU, incluindo suas informações de ID e conexão. | 30/11/2016 |
elastic-inference/associations/ |
Se houver um acelerador do Elastic Inference anexado à instância, ele conterá uma string JSON com informações sobre o acelerador do Elastic Inference, incluindo o ID e o tipo. | 29/11/2018 |
events/maintenance/history |
Se houver eventos de manutenção da instância concluídos ou cancelados, contém uma string JSON com informações sobre os eventos. Para obter mais informações, consulte Para visualizar o histórico de eventos sobre eventos concluídos ou cancelados. | 17/08/2018 |
events/maintenance/scheduled |
Se houver eventos de manutenção da instância ativos, contém uma string JSON com informações sobre os eventos. Para ter mais informações, consulte Visualizar eventos agendados. | 17/08/2018 |
events/recommendations/rebalance |
O tempo aproximado, em UTC, quando a notificação de recomendação de rebalanceamento da instância do EC2 é emitida para a instância. Veja a seguir um exemplo dos metadados para esta categoria: {"noticeTime":
"2020-11-05T08:22:00Z"}. Esta categoria só está disponível após a emissão da notificação. Para ter mais informações, consulte Recomendações de rebalanceamento de instâncias do EC2. |
2020-10-27 |
hostname |
Se a instância do EC2 estiver usando a nomenclatura baseada em IP (IPBN), esse é o hostname DNS de IPv4 privado da instância. Se a instância do EC2 estiver usando nomenclatura baseada em recursos (RBN), esse é o RBN. Em casos em que várias interfaces de rede estão presentes, isso se refere ao dispositivo eth0 (o dispositivo para o qual o número de dispositivo é 0). Para obter mais informações sobre IPBN e RBN, consulte Tipos de nome de host de instância do Amazon EC2. | 1,0 |
iam/info
|
Se houver uma função do IAM associada à instância, conterá informações sobre a última vez que o perfil de instância foi atualizado, incluindo a data LastUpdated, InstanceProfileArn e InstanceProfileId. Caso contrário, não estará presente. | 12/01/2012 |
iam/security-credentials/
|
Se houver uma função do IAM associada à instância, role-name será o nome da função, e role-name conterá as credenciais de segurança temporárias associadas à função (para obter mais informações, consulte Recuperar credenciais de segurança dos metadados da instância). Caso contrário, não estará presente. |
12/01/2012 |
identity-credentials/ec2/info |
Informações sobre as credenciais no identity-credentials/ec2/security-credentials/ec2-instance. |
23/05/2018 |
identity-credentials/ec2/security-credentials/ec2-instance |
As credenciais do perfil de identidade da instância que permitem que o software na instância se identifique para a AWS para oferecer suporte a recursos como o EC2 Instance Connect e à Configuração padrão de gerenciamento de host do AWS Systems Manager. Essas credenciais não têm políticas anexadas, portanto, não têm permissões adicionais de APIs da AWS além de identificar a instância para o recurso da AWS. Para ter mais informações, consulte Perfis de identidade da instância. | 23/05/2018 |
instance-action |
Notifica a instância que ela deve ser reinicializada em preparação para o empacotamento. Valores válidos: none | shutdown |
bundle-pending. |
01/09/2008 |
instance-id |
O ID dessa instância. | 1,0 |
instance-life-cycle |
A opção de compra desta instância. Para ter mais informações, consulte Opções de compra de instância. | 01/10/2019 |
instance-type
|
O tipo da instância. Para ter mais informações, consulte Tipos de instância do Amazon EC2. | 29/08/2007 |
ipv6
|
O endereço IPv6 da instância. Em casos em que várias interfaces de rede estão presentes, isso se refere ao dispositivo eth0 (o dispositivo cujo número de dispositivo é 0) na interface de rede e o primeiro endereço iPv6 atribuído. Se nenhum endereço IPv6 existir na interface de rede[0], esse item não será definido e gerará uma resposta HTTP 404. | 2021-01-03 |
kernel-id
|
O ID do kernel executado com essa instância, se aplicável. | 01/02/2008 |
local-hostname
|
Em casos em que várias interfaces de rede estão presentes, isso se refere ao dispositivo eth0 (o dispositivo para o qual o número de dispositivo é 0). Se a instância do EC2 estiver usando a nomenclatura baseada em IP (IPBN), esse é o hostname DNS de IPv4 privado da instância. Se a instância do EC2 estiver usando nomenclatura baseada em recursos (RBN), esse é o RBN. Para obter mais informações sobre IPBN, RBN e nomenclatura de instâncias do EC2, consulte Tipos de nome de host de instância do Amazon EC2. | 19/01/2007 |
local-ipv4
|
O endereço IPv4 privado da instância. Em casos em que várias interfaces de rede estão presentes, isso se refere ao dispositivo eth0 (o dispositivo para o qual o número de dispositivo é 0). Se esta for uma instância somente IPv6, esse item não será definido e gerará uma resposta HTTP 404. | 1,0 |
mac
|
O endereço Media Access Control (MAC) da instância. Em casos em que várias interfaces de rede estão presentes, isso se refere ao dispositivo eth0 (o dispositivo para o qual o número de dispositivo é 0). | 01/01/2011 |
metrics/vhostmd |
Não está mais disponível. | 01/05/2011 |
network/interfaces/macs/
|
O número de dispositivo exclusivo associado a essa interface. O número do dispositivo corresponde ao nome do dispositivo; por exemplo, um device-number de 2 é para o dispositivo eth2. Essa categoria corresponde aos campos DeviceIndex e device-index que são usados pelos comandos da API do Amazon EC2 e do EC2 para a AWS CLI. |
01/01/2011 |
network/interfaces/macs/
|
O ID da interface de rede. | 01/01/2011 |
network/interfaces/macs/
|
Os endereços IPv4 privados que estão associados a cada endereço IP público e estão atribuídos a essa interface. | 01/01/2011 |
network/interfaces/macs/ |
Os endereços IPv6 atribuídos à interface. | 30/06/2016 |
network/interfaces/macs/ |
O prefixo IPv6 atribuído à interface de rede. | |
network/interfaces/macs/
|
O nome de host DNS IPv4 privado da instância. Em casos em que várias interfaces de rede estão presentes, isso se refere ao dispositivo eth0 (o dispositivo para o qual o número de dispositivo é 0). Se esta for uma instância somente IPv6, esse será o nome baseado em recursos. Para obter mais informações sobre IPBN e RBN, consulte Tipos de nome de host de instância do Amazon EC2. |
19/01/2007 |
network/interfaces/macs/
|
Os endereços IPv4 privados associados à interface. Se esta for uma interface de rede somente IPv6, esse item não será definido e gerará uma resposta HTTP 404. | 01/01/2011 |
network/interfaces/macs/
|
O endereço MAC da instância. | 01/01/2011 |
network/interfaces/macs/
|
O índice da placa de rede. Alguns tipos de instância suportam várias placas de rede. | 01-11-2020 |
network/interfaces/macs/
|
O ID do proprietário da interface de rede. Em ambientes de várias interfaces, um terceiro pode anexar uma interface, como o Elastic Load Balancing. O tráfego em uma interface é sempre cobrado do proprietário da interface. | 01/01/2011 |
network/interfaces/macs/
|
O DNS público da interface (IPv4). Essa categoria só será retornada se o atributo enableDnsHostnames for definido como true. Para ter mais informações, consulte Atributos de DNS para sua VPC no Guia do usuário da Amazon VPC. Se a instância tiver apenas um endereço IPv6 público e nenhum endereço IPv4 público, esse item não será definido e gerará uma resposta HTTP 404. |
01/01/2011 |
network/interfaces/macs/
|
Os endereços IP públicos ou os endereços IP elásticos associados à interface. Pode haver vários endereços IPv4 em uma instância. | 01/01/2011 |
network/interfaces/macs/
|
Grupos de segurança aos quais a interface de rede pertence. | 01/01/2011 |
network/interfaces/macs/
|
Os IDs dos grupos de segurança aos quais a interface de rede pertence. | 01/01/2011 |
network/interfaces/macs/
|
O ID da sub-rede na qual a interface reside. | 01/01/2011 |
network/interfaces/macs/
|
O bloco CIDR IPv4 da sub-rede na qual a interface reside. | 01/01/2011 |
network/interfaces/macs/
|
O bloco CIDR IPv6 da sub-rede na qual a interface reside. | 30/06/2016 |
network/interfaces/macs/
|
O ID da VPC na qual a interface reside. | 01/01/2011 |
network/interfaces/macs/ |
O bloco CIDR IPv4 principal da VPC. | 01/01/2011 |
network/interfaces/macs/ |
Os blocos CIDR IPv4 da VPC. | 30/06/2016 |
network/interfaces/macs/ |
O bloco CIDR IPv6 da VPC na qual a interface reside. | 30/06/2016 |
placement/availability-zone |
A zona de disponibilidade na qual a instância foi executada. | 01/02/2008 |
placement/availability-zone-id |
O ID estático da zona de disponibilidade em que a instância é executada. O ID da zona de disponibilidade é consistente entre as contas. No entanto, pode ser diferente da zona de disponibilidade, que pode variar de acordo com a conta. | 01/10/2019 |
placement/group-name
|
O nome do grupo de posicionamento no qual a instância é executada. | 24/08/2020 |
placement/host-id
|
O ID do host no qual a instância é executada. Aplicável apenas a Hosts dedicados. | 24/08/2020 |
placement/partition-number
|
O número da partição na qual a instância é executada. | 24/08/2020 |
placement/region
|
A região da AWS na qual a instância é executada. | 24/08/2020 |
product-codes
|
AWS Marketplace Os códigos de produtos associados com a instância, se houver. | 01/03/2007 |
public-hostname
|
O DNS público da instância (IPv4). Essa categoria só será retornada se o atributo enableDnsHostnames for definido como true. Para ter mais informações, consulte Atributos de DNS para sua VPC no Guia do usuário da Amazon VPC. Se a instância tiver apenas um endereço IPv6 público e nenhum endereço IPv4 público, esse item não será definido e gerará uma resposta HTTP 404. |
19/01/2007 |
public-ipv4
|
O endereço IPv4 público. Se um endereço IP elástico estiver associado à instância, o valor retornado será o endereço IP elástico. | 19/01/2007 |
public-keys/0/openssh-key
|
Chave pública. Disponível somente se fornecido no momento da execução da instância. | 1,0 |
ramdisk-id
|
O ID do disco de RAM no momento da execução, se aplicável. | 10/10/2007 |
reservation-id
|
O ID da reserva. | 1,0 |
security-groups
|
Os nomes dos grupos de segurança aplicados à instância. Após a execução, você só pode alterar os grupos de segurança das instâncias. Essas alterações estão refletidas aqui e em network/interfaces/macs/ |
1,0 |
services/domain
|
O domínio dos recursos da AWS para a região. |
25/02/2014 |
services/partition
|
A partição na qual o recurso está. Para regiões padrão da AWS a partição é |
20/10/2015 |
spot/instance-action
|
A ação (hibernar, interromper ou encerrar) e o tempo aproximado, em UTC, em que a ação ocorrerá. Esse item estará presente somente se a instância spot tiver sido marcada para hibernar, interromper ou encerrar. Para ter mais informações, consulte instance-action. |
15/11/2016 |
spot/termination-time
|
O tempo aproximado, em UTC, no qual o sistema operacional para sua instância spot receberá o sinal de desligamento. Esse item está presente e contém um valor de tempo (por exemplo, 2015-01-05T18:02:00Z) somente se a instância spot tiver sido marcada para término pelo Amazon EC2. O item hora de encerramento não está definido como uma hora se você mesmo encerrou a instância spot. Para ter mais informações, consulte termination-time. |
05/11/2014 |
tags/instance |
As tags de instância associadas à instância. Somente disponível se você permitir explicitamente acesso a etiquetas em metadados de instância. Para ter mais informações, consulte Permitir acesso a tags em metadados de instância. | 2021-03-23 |
Categorias de dados dinâmicos
A tabela a seguir lista as categorias de dados dinâmicos.
| Categoria | Descrição | Versão quando a categoria foi lançada |
|---|---|---|
fws/instance-monitoring
|
O valor que mostra se o cliente habilitou o monitoramento de um minuto detalhado no CloudWatch. Valores válidos: enabled |
disabled |
04/04/2009 |
instance-identity/document
|
O JSON que contém os atributos da instância, como o ID da instância, o endereço IP privado, etc. Consulte Documentos de identidade da instância. | 04/04/2009 |
instance-identity/pkcs7
|
Usado para verificar a autenticidade e o conteúdo do documentos em relação à assinatura. Consulte Documentos de identidade da instância. | 04/04/2009 |
instance-identity/signature
|
Os dados que podem ser usados por outras partes para verificar sua origem e autenticidade. Consulte Documentos de identidade da instância. | 04/04/2009 |
