Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Compute Cloud
  • Начало работы
    • Обзор
    • Создание виртуальной машины Linux
    • Создание виртуальной машины Windows
    • Создание группы виртуальных машин
  • Пошаговые инструкции
    • Все инструкции
    • Создание виртуальной машины
      • Создать ВМ Linux
      • Создать ВМ Windows
      • Создать ВМ из набора дисков
      • Создать ВМ с дисками из снимков
      • Создать ВМ из пользовательского образа
      • Создать прерываемую ВМ
      • Создать ВМ c GPU
    • DSVM
      • Обзор
      • Создать ВМ из публичного образа DSVM
    • Группы размещения
      • Создать группу размещения
      • Удалить группу размещения
      • Создать ВМ в группе размещения
      • Добавить ВМ в группу размещения
      • Исключить ВМ из группы размещения
    • Образы с предустановленным ПО
      • Создать ВМ из публичного образа
      • Настроить ПО
      • Работа с ВМ на базе публичного образа
      • Получить список публичных образов
    • Получение информации о виртуальной машине
      • Получить информацию о ВМ
      • Получить вывод последовательного порта
    • Управление виртуальной машиной
      • Остановить и запустить ВМ
      • Подключить диск к ВМ
      • Отключить диск от ВМ
      • Перенести ВМ в другую зону доступности
      • Сделать публичный IP-адрес ВМ статическим
      • Изменить ВМ
      • Изменить вычислительные ресурсы ВМ
      • Удалить ВМ
    • Работа на виртуальной машине
      • Подключиться к ВМ по SSH
      • Подключиться к ВМ по RDP
      • Работа с Yandex.Cloud изнутри ВМ
      • Установить NVIDIA-драйверы
    • Создание нового диска
      • Создать пустой диcк
      • Создать пустой диск с блоком большого размера
    • Управление диском
      • Создать снимок диска
      • Изменить диск
      • Удалить диcк
      • Удалить снимок диска
    • Создание нового образа
      • Загрузить свой образ
    • Управление образом
      • Удалить образ
    • Управление серийной консолью
      • Начало работы
      • Подключиться к серийной консоли по SSH
      • Подключиться к серийной консоли с помощью CLI
      • Запустить командную оболочку в Windows SAC
      • Отключить доступ к серийной консоли
    • Создание группы виртуальных машин
      • Создать группу ВМ фиксированного размера
      • Создать группу ВМ фиксированного размера с балансировщиком
      • Создать автоматически масштабируемую группу ВМ
      • Создать группу ВМ с Container Optimized Image
    • Получение информации о группе виртуальных машин
      • Получить список групп ВМ
      • Получить информацию о группе ВМ
      • Получить список ВМ в группе
    • Управление группой виртуальных машин
      • Изменить группу ВМ
      • Настроить проверку состояния приложения на ВМ
      • Обновить группу
        • Постепенное обновление
        • Обновление без простоя
      • Остановить группу ВМ
      • Запустить группу ВМ
      • Удалить группу ВМ
    • Выделенные хосты
      • Создать ВМ в группе выделенных хостов
      • Создать ВМ на выделенном хосте
  • Yandex Container Solution
  • Сценарии использования
    • Настройка синхронизации времени NTP
    • Работа с группой ВМ с автоматическим масштабированием
  • Концепции
    • Взаимосвязь ресурсов
    • Виртуальные машины
      • Обзор
      • Платформы
      • Уровни производительности vCPU
      • Графические ускорители (GPU)
      • Прерываемые виртуальные машины
      • Сеть на виртуальной машине
      • Динамическая миграция
      • Группы размещения
      • Статусы
      • Метаданные
    • Диски
      • Обзор
      • Снимки дисков
    • Образы
    • Группы виртуальных машин
      • Обзор
      • Доступ
      • Шаблон виртуальной машины
      • Переменные в шаблоне виртуальной машины
      • Политики
        • Обзор
        • Политика распределения
        • Политика развертывания
        • Политика масштабирования
      • Типы масштабирования
      • Автоматическое восстановление
      • Обновление
        • Обзор
        • Распределение виртуальных машин по зонам
        • Алгоритм развертывания
        • Правила обновления виртуальных машин
      • Статусы
    • Выделенный хост
    • Резервное копирование
    • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
    • Действующие правила
    • Архив
      • До 1 января 2019 года
      • С 1 января до 1 марта 2019 года
      • С 1 марта до 1 мая 2019 года
  • Справочник API
    • Аутентификация в API
    • gRPC
      • Обзор
      • DiskService
      • DiskTypeService
      • HostGroupService
      • HostTypeService
      • ImageService
      • InstanceService
      • PlacementGroupService
      • SnapshotService
      • ZoneService
      • InstanceGroupService
      • OperationService
    • REST
      • Обзор
      • Disk
        • Обзор
        • create
        • delete
        • get
        • list
        • listOperations
        • update
      • DiskType
        • Обзор
        • get
        • list
      • HostGroup
        • Обзор
        • create
        • delete
        • get
        • list
        • listHosts
        • listInstances
        • listOperations
        • update
      • HostType
        • Обзор
        • get
        • list
      • Image
        • Обзор
        • create
        • delete
        • get
        • getLatestByFamily
        • list
        • listOperations
        • update
      • Instance
        • Обзор
        • attachDisk
        • create
        • delete
        • detachDisk
        • get
        • getSerialPortOutput
        • list
        • listOperations
        • restart
        • start
        • stop
        • update
        • updateMetadata
      • PlacementGroup
        • Обзор
        • create
        • delete
        • get
        • list
        • listInstances
        • listOperations
        • update
      • Snapshot
        • Обзор
        • create
        • delete
        • get
        • list
        • listOperations
        • update
      • Zone
        • Обзор
        • get
        • list
      • Operation
        • Обзор
        • get
      • InstanceGroup
        • Обзор
        • createFromYaml
        • update
        • list
        • get
        • delete
        • start
        • stop
        • create
        • updateFromYaml
        • listLogRecords
        • listInstances
        • listOperations
  • Вопросы и ответы
    • Общие вопросы
    • Виртуальные машины
    • Диски и снимки
    • Аварийное восстановление
    • Лицензирование
    • Все вопросы на одной странице
  1. Пошаговые инструкции
  2. Получение информации о виртуальной машине
  3. Получить информацию о ВМ

Получить информацию о виртуальной машине

  • Получить информацию снаружи виртуальной машины
  • Получить информацию изнутри виртуальной машины
    • Google Compute Engine
    • Amazon EC2

Вы можете получить основную информацию о каждой созданной вами виртуальной машине в консоли управления, на странице виртуальной машины. Чтобы получить детальную информацию вместе с пользовательскими метаданными, воспользуйтесь CLI или API.

Также основную информацию и метаданные можно получить изнутри виртуальной машины.

Получить информацию снаружи виртуальной машины

Консоль управления
CLI
API

В разделе Compute Cloud, на странице Виртуальные машины, приводится список виртуальных машин в каталоге с краткой информацией о них.

Для получения подробной информации о виртуальной машине нажмите на строку с ее именем.

На вкладке:

  • Обзор приводится общая информация о виртуальной машине, в том числе IP-адреса, присвоенные машине.
  • Диски приводится информация о дисках, подключенных к виртуальной машине.
  • Операции приводится список операций с виртуальной машиной и подключенными к ней ресурсами, например дисками.
  • Мониторинг приводится информация о потреблении ресурсов на виртуальной машине. Эту информацию можно получить только в консоли управления или изнутри виртуальной машины.
  • Последовательный порт приводится информация, которую виртуальная машина выводит в последовательный порт. Чтобы получить эту информацию через API или CLI воспользуйтесь инструкцией Получить вывод последовательного порта.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

  1. Посмотрите описание команды для получения вывода последовательного порта:

    $ yc compute instance get --help
    
  2. Выберите виртуальную машину, например first-instance:

    $ yc compute instance list
    +----------------------+-----------------+---------------+---------+----------------------+
    |          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
    +----------------------+-----------------+---------------+---------+----------------------+
    | fhm0b28lgfp4tkoa3jl6 | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
    | fhm9gk85nj7gcoji2f8s | second-instance | ru-central1-a | RUNNING | my second vm via CLI |
    +----------------------+-----------------+---------------+---------+----------------------+
    
  3. Получите основную информацию о виртуальной машине:

    $ yc compute instance get first-instance
    

    Чтобы получить информацию о виртуальной машине вместе с метаданными, используйте флаг --full:

    $ yc compute instance get --full first-instance
    

Для получения основной информации о виртуальной машине используйте метод get для ресурса Instance.

Основная информация не включает пользовательские метаданные, которые были переданы при создании или изменении виртуальной машины. Чтобы получить информацию вместе с метаданными, укажите в параметрах view=FULL.

Получить информацию изнутри виртуальной машины

Изнутри виртуальной машины сервис метаданных доступен по IP-адресу 169.254.169.254.

На данный момент сервис метаданных Yandex.Cloud возвращает метаданные в форматах Google Compute Engine и Amazon EC2.

Google Compute Engine

Сервис метаданных Yandex.Cloud позволяет возвращать метаданные в формате Google Compute Engine.

HTTP-запрос

GET http://169.254.169.254/computeMetadata/v1/instance/
  ? alt=<json|text>
  & recursive=<true|false>
  & wait_for_change=<true|false>
  & last_etag=<string>
  & timeout_sec=<int>
Metadata-Flavor: Google
Параметр Описание
alt Формат ответа (по умолчанию text).
recursive Если true, возвращает все значения по дереву рекурсивно. По умолчанию false.
wait_for_change Если true, ответ будет возвращен только когда один из параметров метаданных изменится. По умолчанию false.
last_etag Значение ETag из предыдущего ответа на аналогичный запрос. Используйте при wait_for_change="true".
timeout_sec Максимальное время ожидания запроса. Используйте при wait_for_change="true".

Примеры запросов

Узнать идентификатор виртуальной машины изнутри машины:

$ curl -H Metadata-Flavor:Google 169.254.169.254/computeMetadata/v1/instance/id

Получить метаданные в формате JSON:

$ curl -H Metadata-Flavor:Google 169.254.169.254/computeMetadata/v1/instance/?recursive=true

Получить метаданные в удобном для чтения формате. Воспользуйтесь утилитой jq:

$ curl -H Metadata-Flavor:Google 169.254.169.254/computeMetadata/v1/instance/?recursive=true | jq -r '.'

Список возвращаемых элементов

Список элементов, которые доступны по этому запросу.

Элемент Описание
attributes/ Пользовательские метаданные, переданные при создании или изменении виртуальной машины в поле metadata.
attributes/ssh-keys Список открытых SSH-ключей, переданных при создании виртуальной машины в поле metadata в значении ключа ssh-keys.
description Текстовое описание, переданное при создании или изменении виртуальной машины.
disks/ Диски, подключенные к виртуальной машине.
hostname FQDN, назначенный виртуальной машине.
id Идентификатор виртуальной машины. ID генерируется автоматически при создании виртуальной машины и уникален в пределах Yandex.Cloud.
name Имя, переданное при создании или изменении виртуальной машины.
networkInterfaces/ Сетевые интерфейсы, подключенные к виртуальной машине.
service-accounts Сервисные аккаунты, привязанные к виртуальной машине.
service-accounts/default/token IAM-токен привязанного сервисного аккаунта.

Другие элементы, например project, используются для обратной совместимости и остаются пустыми.

Amazon EC2

Сервис метаданных Yandex.Cloud позволяет возвращать метаданные в формате Amazon EC2.
При этом формат не поддерживает работу с пользовательскими полями метаданных.

HTTP-запрос

GET http://169.254.169.254/latest/meta-data/<элемент>
Параметр Описание
<элемент> Путь к элементу, который вы хотите получить. Если элемент не задан, в ответе вернется список доступных элементов.

Список возвращаемых элементов

Список элементов, которые доступны по этому запросу.

Примечание

В угловых скобках выделены параметры, которые необходимо заменить значениями. Например, вместо <mac> следует подставить MAC-адрес сетевого интерфейса.

Элемент Описание
hostname Имя хоста, присвоенное виртуальной машине.
instance-id Идентификатор виртуальной машины.
local-ipv4 Внутренний IPv4-адрес.
local-hostname Имя хоста, присвоенное виртуальной машине.
mac MAC-адрес сетевого интерфейса виртуальной машины.
network/interfaces/macs/<mac>/ipv6s Внутренние IPv6-адреса, ассоциированные с сетевым интерфейсом.
network/interfaces/macs/<mac>/local-hostname Имя хоста, ассоциированное с сетевым интерфейсом.
network/interfaces/macs/<mac>/local-ipv4s Внутренние IPv4-адреса, ассоциированные с сетевым интерфейсом.
network/interfaces/macs/<mac>/mac MAC-адрес сетевого интерфейса виртуальной машины.
public-ipv4 Внешний IPv4-адрес.

Примеры запросов

Получить внутренний IP-адрес изнутри виртуальной машины:

$ curl http://169.254.169.254/latest/meta-data/local-ipv4
В этой статье:
  • Получить информацию снаружи виртуальной машины
  • Получить информацию изнутри виртуальной машины
  • Google Compute Engine
  • Amazon EC2
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»