Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
© 2022 ООО «Яндекс.Облако»
Yandex Compute Cloud
  • Начало работы
    • Обзор
    • Создание виртуальной машины Linux
    • Создание виртуальной машины Windows
    • Создание группы виртуальных машин
  • Пошаговые инструкции
    • Все инструкции
    • Создание виртуальной машины
      • Создать ВМ Linux
      • Создать ВМ Windows
      • Создать ВМ из набора дисков
      • Создать ВМ с дисками из снимков
      • Создать ВМ из пользовательского образа
      • Создать ВМ c GPU
      • Сделать ВМ прерываемой
    • DSVM
      • Обзор
      • Создать ВМ из публичного образа DSVM
    • Группы размещения
      • Создать группу размещения
      • Удалить группу размещения
      • Создать ВМ в группе размещения
      • Добавить ВМ в группу размещения
      • Исключить ВМ из группы размещения
    • Образы с предустановленным ПО
      • Создать ВМ из публичного образа
      • Настроить ПО
      • Работа с ВМ на базе публичного образа
      • Получить список публичных образов
    • Получение информации о виртуальной машине
      • Получить информацию о ВМ
      • Получить вывод последовательного порта
    • Управление виртуальной машиной
      • Остановить и запустить ВМ
      • Подключить диск к ВМ
      • Отключить диск от ВМ
      • Перенести ВМ в другую зону доступности
      • Перенести ВМ в другой каталог
      • Привязать к ВМ публичный IP-адрес
      • Сделать публичный IP-адрес ВМ статическим
      • Изменить ВМ
      • Изменить вычислительные ресурсы ВМ
      • Удалить ВМ
    • Работа на виртуальной машине
      • Подключиться к ВМ по SSH
      • Подключиться к ВМ по RDP
      • Подключиться к ВМ через PowerShell
      • Работа с Yandex Cloud изнутри ВМ
      • Установить NVIDIA-драйверы
      • Восстановить доступ к ВМ
    • Создание диска
      • Создать пустой диcк
      • Создать пустой диск с блоком большого размера
      • Создать нереплицируемый диск
    • Управление диском
      • Создать снимок диска
      • Изменить диск
      • Перенести диск в другой каталог
      • Удалить диcк
      • Удалить снимок диска
    • Группы размещения дисков
      • Создать группу размещения дисков
      • Удалить диск из группы размещения
    • Создание образа
      • Подготовить образ диска
      • Загрузить свой образ
      • Создать образ из диска
      • Создать образ из снимка диска
      • Создать образ из другого пользовательского образа
    • Управление образом
      • Получить список образов
      • Удалить образ
    • Файловые хранилища
      • Создать файловое хранилище
      • Подключить файловое хранилище к ВМ
      • Отключить файловое хранилище от ВМ
      • Изменить файловое хранилище
      • Удалить файловое хранилище
    • Управление серийной консолью
      • Начало работы
      • Подключиться к серийной консоли по SSH
      • Подключиться к серийной консоли с помощью CLI
      • Запустить командную оболочку в Windows SAC
      • Отключить доступ к серийной консоли
    • Создание группы виртуальных машин
      • Создать группу ВМ фиксированного размера
      • Создать группу ВМ фиксированного размера с сетевым балансировщиком
      • Создать группу ВМ фиксированного размера с L7-балансировщиком
      • Создать автоматически масштабируемую группу ВМ
      • Создать группу ВМ с Container Optimized Image
      • Создать группу ВМ по YAML-спецификации
    • Получение информации о группе виртуальных машин
      • Получить список групп ВМ
      • Получить информацию о группе ВМ
      • Получить список ВМ в группе
    • Управление группой виртуальных машин
      • Изменить группу ВМ
      • Изменить группу ВМ по YAML-спецификации
      • Настроить проверку состояния приложения на ВМ
      • Обновить группу
        • Постепенное обновление
        • Обновление без простоя
      • Приостановить процессы в группе ВМ
      • Возобновить процессы в группе ВМ
      • Остановить группу ВМ
      • Запустить группу ВМ
      • Удалить группу ВМ
    • Выделенные хосты
      • Создать ВМ в группе выделенных хостов
      • Создать ВМ на выделенном хосте
  • Yandex Container Solution
  • Практические руководства
    • Настройка синхронизации времени NTP
    • Работа с группой ВМ с автоматическим масштабированием
    • Автомасштабирование группы ВМ для обработки сообщений из очереди
    • Обновление группы ВМ под нагрузкой
    • Развертывание Remote Desktop Gateway
    • Передача логов с ВМ в Yandex Cloud Logging
  • Концепции
    • Взаимосвязь ресурсов
    • Виртуальные машины
      • Обзор
      • Платформы
      • Уровни производительности vCPU
      • Прерываемые виртуальные машины
      • Сеть на виртуальной машине
      • Программно-ускоренная сеть
      • Динамическая миграция
      • Группы размещения
      • Статусы
      • Метаданные
    • Графические ускорители GPU и vGPU
    • Диски и файловые хранилища
      • Обзор
      • Диски
      • Снимки дисков
      • Группы размещения нереплицируемых дисков
      • Файловые хранилища
      • Операции чтения и записи
    • Образы
    • Группы виртуальных машин
      • Обзор
      • Доступ
      • YAML-спецификация
      • Шаблон виртуальной машины
      • Переменные в шаблоне виртуальной машины
      • Политики
        • Обзор
        • Политика распределения
        • Политика развертывания
        • Политика масштабирования
      • Типы масштабирования
      • Автоматическое восстановление
      • Обновление
        • Обзор
        • Распределение виртуальных машин по зонам
        • Алгоритм развертывания
        • Правила обновления виртуальных машин
        • Изменение дополнительных дисков в шаблоне виртуальной машины
      • Остановка группы и приостановка процессов
      • Статусы
    • Выделенный хост
    • Резервное копирование
    • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
    • Действующие правила
    • Архив
      • До 1 января 2019 года
      • С 1 января до 1 марта 2019 года
      • С 1 марта до 1 мая 2019 года
  • Справочник API
    • Аутентификация в API
    • gRPC (англ.)
      • Overview
      • DiskPlacementGroupService
      • DiskService
      • DiskTypeService
      • FilesystemService
      • HostGroupService
      • HostTypeService
      • ImageService
      • InstanceService
      • PlacementGroupService
      • SnapshotService
      • ZoneService
      • InstanceGroupService
      • OperationService
    • REST (англ.)
      • Overview
      • DiskPlacementGroup
        • Overview
        • create
        • delete
        • get
        • list
        • listDisks
        • listOperations
        • update
      • Disk
        • Overview
        • create
        • delete
        • get
        • list
        • listOperations
        • move
        • update
      • DiskType
        • Overview
        • get
        • list
      • Filesystem
        • Overview
        • create
        • delete
        • get
        • list
        • listOperations
        • update
      • HostGroup
        • Overview
        • create
        • delete
        • get
        • list
        • listHosts
        • listInstances
        • listOperations
        • update
      • HostType
        • Overview
        • get
        • list
      • Image
        • Overview
        • create
        • delete
        • get
        • getLatestByFamily
        • list
        • listOperations
        • update
      • Instance
        • Overview
        • addOneToOneNat
        • attachDisk
        • attachFilesystem
        • create
        • delete
        • detachDisk
        • detachFilesystem
        • get
        • getSerialPortOutput
        • list
        • listOperations
        • move
        • removeOneToOneNat
        • restart
        • start
        • stop
        • update
        • updateMetadata
        • updateNetworkInterface
      • PlacementGroup
        • Overview
        • create
        • delete
        • get
        • list
        • listInstances
        • listOperations
        • update
      • Snapshot
        • Overview
        • create
        • delete
        • get
        • list
        • listOperations
        • update
      • Zone
        • Overview
        • get
        • list
      • Operation
        • Overview
        • get
      • InstanceGroup
        • Overview
        • list
        • get
        • listLogRecords
        • updateFromYaml
        • updateAccessBindings
        • pauseProcesses
        • stop
        • start
        • delete
        • listInstances
        • createFromYaml
        • update
        • setAccessBindings
        • listOperations
        • create
        • listAccessBindings
        • resumeProcesses
  • Вопросы и ответы
    • Общие вопросы
    • Виртуальные машины
    • Подключение
    • Диски, снимки, образы
    • Аварийное восстановление
    • Мониторинг
    • Лицензирование
    • Все вопросы на одной странице
  1. Пошаговые инструкции
  2. Получение информации о виртуальной машине
  3. Получить информацию о ВМ

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

Статья создана
Yandex.Cloud
,
улучшена
amatol
  • Получить информацию снаружи виртуальной машины
  • Получить информацию изнутри виртуальной машины
    • 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

Была ли статья полезна?

Language / Region
© 2022 ООО «Яндекс.Облако»
В этой статье:
  • Получить информацию снаружи виртуальной машины
  • Получить информацию изнутри виртуальной машины
  • Google Compute Engine
  • Amazon EC2