Каталоги метаданных
Сервис метаданных ВМ предоставляет доступ к следующим каталогам с метаданными:
Каталог | Путь |
---|---|
computeMetadata |
/computeMetadata/v1/ |
user-data |
/latest/user-data/ |
computeMetadata
Каталог computeMetadata
содержит следующие основные ключи:
Название ключа (путь) |
Описание |
Пример значения |
instance/attributes/enable-oslogin |
Ключ, отвечающий за доступ к ВМ через OS Login. Возможные значения:- |
|
instance/attributes/install-unified-agent |
Ключ, отвечающий за установку на ВМ агента Unified Agent. Возможные значения:- |
|
instance/attributes/serial-port-enable |
Ключ, отвечающий за доступ к ВМ через серийную консоль. Возможные значения:- |
|
instance/description |
Описание ВМ. |
|
instance/hostname |
Полное внутренне имя ВМ (FQDN). |
|
instance/id |
Идентификатор ВМ. |
|
instance/maintenance-event |
Ключ, указывающий, наступило ли событие по обслуживанию ВМ. |
|
instance/name |
Имя ВМ. |
|
instance/zone |
Идентификатор зоны доступности в формате |
|
instance/disks/ |
Список индексов дисков ВМ. |
|
instance/disks/<индекс_диска>/device-name |
Идентификатор диска. |
|
instance/disks/<индекс_диска>/mode |
Режим работы диска. |
|
instance/disks/<индекс_диска>/type |
Тип диска. |
|
instance/disks/<индекс_диска>/index |
Индекс в списке индексов дисков ВМ. |
|
instance/network-interfaces/ |
Список индексов сетевых интерфейсов ВМ. |
|
instance/network-interfaces/<индекс_интерфейса>/ip |
Внутренний IPv4-адрес сетевого интерфейса ВМ. |
|
instance/network-interfaces/<индекс_интерфейса>/mac |
MAC-адрес сетевого интерфейса ВМ. |
|
instance/network-interfaces/<индекс_интерфейса>/network |
Идентификатор подсети, к которой подключен сетевой интерфейс. |
|
instance/network-interfaces/<индекс_интерфейса>/access-configs/<индекс_интерфейса>/external-ip |
Публичный IP-адрес сетевого интерфейса ВМ. |
|
instance/network-interfaces/<индекс_интерфейса>/access-configs/<индекс_интерфейса>/type |
Тип внешней связности сетевого интерфейса ВМ. |
|
instance/service-accounts/ |
Ключ, указывающий, привязан ли к ВМ сервисный аккаунт. Если сервисный аккаунт не привязан, ключ ничего не возвращает. |
|
instance/service-accounts/default/token |
|
|
instance/vendor/cloud-id |
Идентификатор облака, в котором создана ВМ. |
|
instance/vendor/folder-id |
Идентификатор каталога, в котором создана ВМ. |
|
instance/vendor/identity/document |
Идентификационный документ в формате JSON, в котором содержится информация об идентификаторе ВМ ( |
|
instance/vendor/identity/base64 |
Криптографическая подпись идентификационного документа в формате Base64 |
|
instance/vendor/identity/dsa |
Криптографическая подпись идентификационного документа в формате DSA |
|
instance/vendor/labels |
Список ключей меток, которые привязаны к ВМ. |
|
instance/vendor/labels/<ключ_метки> |
Значение для выбранного ключа метки из списка. |
|
instance/vendor/environment |
Облачный регион. |
|
yandex/folder-id |
Идентификатор каталога, в котором создана ВМ. |
|
user-data
Каталог user-data
не содержит отдельных ключей, и все данные отдаются сразу целиком при обращении к корневому ключу каталога /latest/user-data/
.
В этом каталоге хранится метаинформация, которая задается пользователем при создании или изменении ВМ. Получателем этой информации является процесс cloud-init
Чтобы получить информацию из этого каталога, нужно выполнить запрос.
Внимание
Все данные в каталоге метаданных user-data
будут доступны в открытом виде любому пользователю, имеющему терминальный доступ к ВМ.