Метод list

Возвращает список доступных ресурсов Instance в указанном каталоге.

HTTP-запрос

GET https://compute.api.cloud.yandex.net/compute/v1/instances

Query-параметры

Параметр Описание
folderId Обязательное поле. Идентификатор каталога для получения списка виртуальных машин. Чтобы получить идентификатор каталога, используйте запрос list. Максимальная длина строки в символах — 50.
pageSize Максимальное количество результатов на странице ответа на запрос. Если количество результатов больше чем pageSize, сервис вернет значение nextPageToken, которое можно использовать для получения следующей страницы. Максимальное значение — 1000.
pageToken Токен страницы. Установите значение pageToken равным значению поля nextPageToken прошлого запроса, чтобы получить следующую страницу результатов. Максимальная длина строки в символах — 100.
filter Параметры фильтрации ресурсов в ответе. В параметрах фильтрации указываются: 1. Имя поля. В настоящее время фильтрация осуществляется только по полю Instance.name. 2. Оператор. Операторы = или != для одиночных значений, IN или NOT IN для списков значений. 3. Значение. Значение длиной от 3 до 63 символов, совпадающее с регулярным выражением ^[a-z]([-a-z0-9]{1,61}[a-z0-9])?$. Максимальная длина строки в символах — 1000.

Ответ

HTTP Code: 200 - OK

 {
  "instances": [
    {
      "id": "string",
      "folderId": "string",
      "createdAt": "string",
      "name": "string",
      "description": "string",
      "labels": "object",
      "zoneId": "string",
      "platformId": "string",
      "resources": {
        "memory": "string",
        "cores": "string",
        "coreFraction": "string"
      },
      "status": "string",
      "metadata": "object",
      "bootDisk": {
        "mode": "string",
        "deviceName": "string",
        "autoDelete": true,
        "diskId": "string"
      },
      "secondaryDisks": [
        {
          "mode": "string",
          "deviceName": "string",
          "autoDelete": true,
          "diskId": "string"
        }
      ],
      "networkInterfaces": [
        {
          "index": "string",
          "macAddress": "string",
          "subnetId": "string",
          "primaryV4Address": {
            "address": "string",
            "oneToOneNat": {
              "address": "string",
              "ipVersion": "string"
            }
          },
          "primaryV6Address": {
            "address": "string",
            "oneToOneNat": {
              "address": "string",
              "ipVersion": "string"
            }
          }
        }
      ],
      "fqdn": "string"
    }
  ],
  "nextPageToken": "string"
}
Поле Описание
instances[] object

Ресурс Instance. Подробнее см. Виртуальные машины.

instances[].
id
string

Идентификатор виртуальной машины.

instances[].
folderId
string

Идентификатор каталога, которому принадлежит виртуальная машина.

instances[].
createdAt
string (date-time)

Время создания ресурса в формате в RFC3339.

instances[].
name
string

Имя виртуальной машины. Длина 1-63 символов.

instances[].
description
string

Описание виртуальной машины. Длина описания должна быть от 0 до 256 символов.

instances[].
labels
object

Метки ресурса в формате ключ:значение. Максимум 64 на ресурс.

instances[].
zoneId
string

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

instances[].
platformId
string

Идентификатор аппаратной платформы виртуальной машины.

instances[].
resources
object

Вычислительные ресурсы виртуальной машины, такие как объем памяти и количество ядер.

instances[].
resources.
memory
string (int64)

Объем памяти в байтах, доступный виртуальной машине.

instances[].
resources.
cores
string (int64)

Количество ядер, доступных виртуальной машине.

instances[].
resources.
coreFraction
string (int64)

Базовый уровень производительности CPU с возможностью повышения производительности выше этого уровня. Это поле устанавливает базовую производительность для каждого ядра.

instances[].
status
string

Статус виртуальной машины.

  • PROVISIONING: Виртуальная машина ожидает выделения ресурсов.
  • RUNNING: Виртуальная машина работает нормально.
  • STOPPING: Виртуальная машина останавливается.
  • STOPPED: Виртуальная машина остановлена.
  • STARTING: Виртуальная машина запускается.
  • RESTARTING: Виртуальная машина перезапускается.
  • UPDATING: Виртуальная машина обновляется.
  • ERROR: С виртуальной машиной произошла ошибка, блокирующая работу.
  • CRASHED: Виртуальная машина аварийно завершила работу и будет перезапущена автоматически.
  • DELETING: Виртуальная машина удаляется.
instances[].
metadata
object

Метаданные, назначенные этой виртуальной машине, в формате пар ключ/значение. Это включает произвольные пользовательские метаданные и предзаданные ключи.

Например, можно использовать метаданные для доставки открытого ключа SSH на виртуальную машину. Подробнее см. Метаданные виртуальной машины.

instances[].
bootDisk
object

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

Добавленные диски

instances[].
bootDisk.
mode
string

Режим доступа к ресурсу Disk.

  • READ_ONLY: Доступ на чтение.
  • READ_WRITE: Доступ на чтение и запись.
instances[].
bootDisk.
deviceName
string

Cерийный номер, который на виртуальной машине с операционной системой Linux отображается в директории /dev/disk/by-id/.

Это значение может использоваться для ссылки на устройство внутри виртуальной машины при монтировании, изменении размера и т. д.

instances[].
bootDisk.
autoDelete
boolean (boolean)

Указывает, должен ли диск автоматически удалиться при удалении виртуальной машины.

instances[].
bootDisk.
diskId
string

Идентификатор диска, подключенного к виртуальной машине.

instances[].
secondaryDisks[]
object

Добавленные диски

instances[].
secondaryDisks[].
mode
string

Режим доступа к ресурсу Disk.

  • READ_ONLY: Доступ на чтение.
  • READ_WRITE: Доступ на чтение и запись.
instances[].
secondaryDisks[].
deviceName
string

Cерийный номер, который на виртуальной машине с операционной системой Linux отображается в директории /dev/disk/by-id/.

Это значение может использоваться для ссылки на устройство внутри виртуальной машины при монтировании, изменении размера и т. д.

instances[].
secondaryDisks[].
autoDelete
boolean (boolean)

Указывает, должен ли диск автоматически удалиться при удалении виртуальной машины.

instances[].
secondaryDisks[].
diskId
string

Идентификатор диска, подключенного к виртуальной машине.

instances[].
networkInterfaces[]
object

Массив сетевых интерфейсов, присоединенных к виртуальной машине.

instances[].
networkInterfaces[].
index
string

Порядковый номер сетевого интерфейса, генерируемый сервером, 0,1,2... и так далее. В настоящее время поддерживается только один сетевой интерфейс для виртуальной машины.

instances[].
networkInterfaces[].
macAddress
string

MAC-адрес, назначенный сетевому интерфейсу.

instances[].
networkInterfaces[].
subnetId
string

Идентификатор подсети.

instances[].
networkInterfaces[].
primaryV4Address
object

Primary IPv4-адрес, который назначен виртуальной машине для данного сетевого интерфейса.

instances[].
networkInterfaces[].
primaryV4Address.
address
string

Внутренний IPv4-адрес, назначенный виртуальной машине для этого сетевого интерфейса.

instances[].
networkInterfaces[].
primaryV4Address.
oneToOneNat
object

Конфигурация One-to-one NAT. Если отсутствует, NAT не был настроен.

instances[].
networkInterfaces[].
primaryV4Address.
oneToOneNat.
address
string

Внешний IP-адрес, связанный с этой виртуальной машиной.

instances[].
networkInterfaces[].
primaryV4Address.
oneToOneNat.
ipVersion
string

Версия IP для внешнего IP-адреса.

  • IPV4: IPv4-адрес, например 192.0.2.235.
  • IPV6: IPv6-адрес, например, 2001:0db8:85a3:0000:0000:8a2e:0370:7334.
instances[].
networkInterfaces[].
primaryV6Address
object

Primary IPv6-адрес, который назначен виртуальной машине для данного сетевого интерфейса. IPv6 еще не доступен.

instances[].
networkInterfaces[].
primaryV6Address.
address
string

Внутренний IPv4-адрес, назначенный виртуальной машине для этого сетевого интерфейса.

instances[].
networkInterfaces[].
primaryV6Address.
oneToOneNat
object

Конфигурация One-to-one NAT. Если отсутствует, NAT не был настроен.

instances[].
networkInterfaces[].
primaryV6Address.
oneToOneNat.
address
string

Внешний IP-адрес, связанный с этой виртуальной машиной.

instances[].
networkInterfaces[].
primaryV6Address.
oneToOneNat.
ipVersion
string

Версия IP для внешнего IP-адреса.

  • IPV4: IPv4-адрес, например 192.0.2.235.
  • IPV6: IPv6-адрес, например, 2001:0db8:85a3:0000:0000:8a2e:0370:7334.
instances[].
fqdn
string

Доменное имя виртуальной машины. FQDN определяется сервером в формате <hostname>.<region_id>.internal при создании виртуальной машины. Если доменное имя не было определено при создании виртуальной машины, FQDN будет <id>.auto.internal.

nextPageToken string

Токен для получения следующей страницы результатов в ответе. Если количество результатов больше чем pageSize, используйте nextPageToken в качестве значения параметра pageToken в следующем запросе списка ресурсов. Все последующие запросы будут получать свои значения nextPageToken для перебора страниц результатов.