Метаданные виртуальной машины

Метаданные виртуальной машины — это метаинформация (дополнительная информация) о виртуальной машине.

Сервис метаданных виртуальной машины хранит метаданные в каталогах в виде пар ключ-значение.

Метаданные могут использоваться:

• Для работы процесса 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.

Настроить параметры сервиса метаданных вы можете при создании или изменении ВМ. Подробнее о том, как настроить параметры сервиса метаданных, см. в инструкции.

Примеры использованияПримеры использования

• Безопасная передача пароля в скрипт инициализации
• Безопасное хранение паролей для GitLab CI в виде секретов Yandex Lockbox

См. такжеСм. также

• Каталоги метаданных
• Ключи, обрабатываемые в публичных образах Yandex Cloud
• Передача метаданных в виртуальные машины
• Доступ к метаданным виртуальных машин
• Идентификационный документ
• Шаблон виртуальной машины