Метаданные виртуальной машины
Примечание
Получить прямой доступ (без аутентификации) к метаданным можно через специальный сервис метаданных, доступный внутри ВМ по URL http://169.254.169.254. Сервис метаданных внутри ВМ доступен для всех виртуальных машин, независимо от их сетевых настроек и наличия доступа в интернет.
Метаданные виртуальной машины — это метаинформация (дополнительная информация) о виртуальной машине.
Сервис метаданных виртуальной машины хранит метаданные в каталогах в виде пар ключ-значение.
Метаданные могут использоваться:
- Для работы процесса cloud-init при создании ВМ.
- Для передачи в ключе
user-dataнеобходимой информации сервисам или приложениям, которые запускаются на ВМ уже после ее создания. - Для получения изнутри ВМ данных, необходимых для аутентификации в Yandex Cloud.
Идентификатор виртуальной машины, идентификатор образа Cloud Marketplace, а также ряд других значений из состава метаданных формируют уникальный идентификационный документ этой виртуальной машины.
Параметры сервиса метаданных ВМ
В Yandex Cloud доступ к метаданным ВМ можно получить в формате Google Compute Engine (поддерживаются не все поля). Этот формат является наиболее безопасным и рекомендуемым форматом работы с метаданными ВМ. При обращении к сервису метаданных необходимо использовать HTTP-заголовок Metadata-Flavor:Google.
В виртуальных машинах Compute Cloud доступны следующие настройки сервиса метаданных ВМ:
gce-http-endpoint— обеспечивает доступ к метаданным с использованием формата Google Compute Engine. Возможные значения:enabled,disabled. Если для опции задано значениеdisabled, то запрос к метаданным завершится ошибкой400(BadRequest). Значение по умолчанию:enabled.gce-http-token— обеспечивает доступ к получению через метаданные Google Compute Engine IAM-токена сервисного аккаунта, подключенного к ВМ. Возможные значения:enabled,disabled. Если для опции задано значениеdisabled, то запрос на получение токена завершится ошибкой400(BadRequest). Значение по умолчанию:enabled.
Получить текущие значения параметров сервиса метаданных ВМ вы можете вместе с информацией о ВМ с помощью CLI и API.
Настроить параметры сервиса метаданных вы можете при создании или изменении ВМ. Подробнее о том, как настроить параметры сервиса метаданных, см. в инструкции.