Категории метаданных экземпляра#

Все метаданные возвращаются в текстовом формате. При запросе отдельного ресурса возвращается соответствующее ему значение, либо ошибка “404 — Not Found”, если ресурс недоступен. При запросе общего ресурса метаданных (URI таких ресурсов заканчивается /) возвращается список доступных ресурсов, либо “404 — Not Found”, если таковые отсутствуют. Доступная версия на текущий момент времени — latest.

В таблице ниже приведены категории метаданных экземпляра

/latest/meta-data/#

Endpoint

Описание

Пример

ami-id

CMI ID для запуска экземпляра.

cmi-XXXXXXXX

ami-launch-index

При одновременном старте одного и того же экземпляра данное значение укажет на порядок загрузки. Начальное значение первого запущенного экземпляра равно 0.

<index number>

block-device-mapping/ami

Имя блочного устройства, на котором располагается файловая система root/boot.

/dev/<partition id>

block-device-mapping/root

Имя блочного устройства, на котором располагается корневая файловая система (/ или C:).

/dev/vda

block-device-mapping/ebs<N>

Имя блочного устройства, ассоциированного с дополнительным EBS-диском. N — номер подключённого диска к экземпляру. Например, для экземпляра с двумя подключёнными дисками, эндпоинт block-device-mapping/ebs2 вернёт /dev/vdb.

/deb/vdb

instance-type

Тип экземпляра.

m1.small

instance-id

ID экземпляра.

i-XXXXXXXX

hostname

ID или приватный DNS экземпляра.

i-XXXXXXXX

local-hostname

Частное имя хост-системы экземпляра. В случае если присутствует несколько интерфейсов, оно будет относиться к eth0, т.е. к устройству со значением 0.

ip-XXX-XXX-XXX-XXX.vpc-XXXXXXXX.internal

local-ipv4

Частный IPv4-адрес экземпляра. В случае если присутствует несколько интерфейсов, он будет относиться к eth0, т.е. к устройству со значением 0.

XXX.XXX.XXX.XXX

public-hostname

Публичный DNS интерфейса. В случае если экземпляр находится в VPC, эта категория возвращается тогда, когда установлен атрибут enableDnsHostnames, который принимает значение True.

c2-XXX-XXX-XXX-XXX.elastic.k2.cloud

public-keys/<number>

Публичный ключ. Доступен, если указан во время запуска экземпляра.

ssh-rsa AAAAB3N…

public-ipv4

EIP-адреса (Elastic IP Addresses), связанные с интерфейсом. В одном экземпляре может находиться несколько IPv4-адресов.

XXX.XXX.XXX.XXX

placement/availability-zone

Availability Zone, в которой запущен экземпляр.

ru-msk-comp1p

reservation-id

ID группы экземпляров, запущенных одним запросом RunInstances.

r-XXXXXXXX

security-groups

Имена групп безопасности, к которым принадлежит сетевой интерфейс. Вернёт соответствующее значение для экземпляров, которые запущены в VPC.

sg-XXXXXXXX

mac

MAC-адрес основного интерфейса экземпляра.

XX:XX:XX:XX:XX:XX

tags/instance

Теги экземпляра.

{<tag key>: <tag value>}

tags/volumes/<volume_id>

Теги виртуального диска экземпляра.

{<tag key>: <tag value>}
/latest/meta-data/network/interfaces/macs/<interface_mac>/#

Endpoint

Описание

Пример

device-number

Номер интерфейса.

<index number>

ipv4-associations/<public_ip>

Приватный IPv4-адрес, на который назначен публичный IPv4-адрес.

XXX.XXX.XXX.XXX

local-hostname

Частное имя хост-системы экземпляра. В случае если присутствует несколько интерфейсов, оно будет относиться к eth0, т.е. к устройству со значением 0.

ip-XXX-XXX-XXX-XXX.vpc-XXXXXXXX.internal

local-ipv4s

Частный IPv4-адрес экземпляра. В случае если присутствует несколько интерфейсов, он будет относиться к eth0, т.е. к устройству со значением 0.

XXX.XXX.XXX.XXX

mac

MAC-адрес основного интерфейса экземпляра.

XX:XX:XX:XX:XX:XX

public-hostname

Публичный DNS интерфейса. В случае если экземпляр находится в VPC, эта категория возвращается тогда, когда установлен атрибут enableDnsHostnames, который принимает значение True.

c2-XXX-XXX-XXX-XXX.elastic.k2.cloud

public-ipv4s

EIP-адреса (Elastic IP Addresses), связанные с экземпляром. В одном экземпляре может находиться несколько IPv4-адресов.

XXX.XXX.XXX.XXX

security-group-ids

Идентификаторы групп безопасности, к которым принадлежит сетевой интерфейс. Вернёт соответствующее значение для экземпляров, которые запущены в VPC.

sg-XXXXXXXX

security-groups

Имена групп безопасности, к которым принадлежит сетевой интерфейс. Вернёт соответствующее значение для экземпляров, которые запущены в VPC.

security_group_name

subnet-id

ID подсети, в которой запущен экземпляр.

subnet-XXXXXXXX

subnet-ipv4-cidr-block

Блок IPv4-адресов подсети в нотации CIDR.

XXX.XXX.XXX.XXX/YY

vpc-id

ID VPC, в котором запущен экземпляр.

vpc-XXXXXXXX

vpc-ipv4-cidr-block

Блок IPv4-адресов VPC в нотации CIDR.

XXX.XXX.XXX.XXX/YY

vpc-ipv4-cidr-blocks

Список блоков IPv4-адресов в нотации CIDR.

XXX.XXX.XXX.XXX/YY