Instance

JSON-представление
Методы

Набор методов для управления ресурсами Instance.

JSON-представление

{
  "id": "string",
  "folderId": "string",
  "createdAt": "string",
  "name": "string",
  "description": "string",
  "labels": "object",
  "zoneId": "string",
  "platformId": "string",
  "resources": {
    "memory": "string",
    "cores": "string",
    "coreFraction": "string",
    "gpus": "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",
  "schedulingPolicy": {
    "preemptible": true
  },
  "serviceAccountId": "string"
}

Поле	Описание
id	string Идентификатор виртуальной машины.
folderId	string Идентификатор каталога, которому принадлежит виртуальная машина.
createdAt	string (date-time) Строка в формате RFC3339.
name	string Имя виртуальной машины. Длина 1-63 символов.
description	string Описание виртуальной машины. Длина описания должна быть от 0 до 256 символов.
labels	object Метки ресурса в формате `key:value`. Максимум 64 на ресурс.
zoneId	string Идентификатор зоны доступности, где находится виртуальная машина.
platformId	string Идентификатор аппаратной платформы виртуальной машины.
resources	object Вычислительные ресурсы виртуальной машины, такие как объем памяти и количество ядер.
resources. memory	string (int64) Объем памяти в байтах, доступный виртуальной машине.
resources. cores	string (int64) Количество ядер, доступных виртуальной машине.
resources. coreFraction	string (int64) Базовый уровень производительности CPU с возможностью повышения производительности выше этого уровня. Это поле устанавливает базовую производительность для каждого ядра.
resources. gpus	string (int64) Количество GPU, доступных виртуальной машине.
status	string Статус виртуальной машины. PROVISIONING: Виртуальная машина ожидает выделения ресурсов. RUNNING: Виртуальная машина работает нормально. STOPPING: Виртуальная машина останавливается. STOPPED: Виртуальная машина остановлена. STARTING: Виртуальная машина запускается. RESTARTING: Виртуальная машина перезапускается. UPDATING: Виртуальная машина обновляется. ERROR: С виртуальной машиной произошла ошибка, блокирующая работу. CRASHED: Виртуальная машина аварийно завершила работу и будет перезапущена автоматически. DELETING: Виртуальная машина удаляется.
metadata	object Метаданные в формате пар `key:value`, назначаемые данной виртуальной машине. Сюда входят пользовательские метаданные и предопределенные ключи. Например, можно использовать метаданные для доставки открытого ключа SSH на виртуальную машину. Дополнительные сведения см. в разделе Метаданные виртуальной машины.
bootDisk	object Загрузочный диск, подключенный к виртуальной машине.
bootDisk. mode	string Режим доступа к ресурсу Disk. READ_ONLY: Доступ на чтение. READ_WRITE: Доступ на чтение и запись.
bootDisk. deviceName	string Cерийный номер, который на виртуальной машине с операционной системой Linux отображается в директории /dev/disk/by-id/. Это значение может использоваться для ссылки на устройство внутри виртуальной машины при монтировании, изменении размера и т. д.
bootDisk. autoDelete	boolean (boolean) Указывает, должен ли диск автоматически удалиться при удалении виртуальной машины.
bootDisk. diskId	string Идентификатор диска, подключенного к виртуальной машине.
secondaryDisks[]	object Массив дополнительных дисков, подключенных к виртуальной машине.
secondaryDisks[]. mode	string Режим доступа к ресурсу Disk. READ_ONLY: Доступ на чтение. READ_WRITE: Доступ на чтение и запись.
secondaryDisks[]. deviceName	string Cерийный номер, который на виртуальной машине с операционной системой Linux отображается в директории /dev/disk/by-id/. Это значение может использоваться для ссылки на устройство внутри виртуальной машины при монтировании, изменении размера и т. д.
secondaryDisks[]. autoDelete	boolean (boolean) Указывает, должен ли диск автоматически удалиться при удалении виртуальной машины.
secondaryDisks[]. diskId	string Идентификатор диска, подключенного к виртуальной машине.
networkInterfaces[]	object Массив сетевых интерфейсов, присоединенных к виртуальной машине.
networkInterfaces[]. index	string Индекс сетевого интерфейса, генерируемого сервером, 0,1,2... В настоящее время для каждой виртуальной машины поддерживается только один сетевой интерфейс.
networkInterfaces[]. macAddress	string MAC-адрес, назначенный сетевому интерфейсу.
networkInterfaces[]. subnetId	string Идентификатор подсети.
networkInterfaces[]. primaryV4Address	object Основной IPv4-адрес, который назначен виртуальной машине для данного сетевого интерфейса.
networkInterfaces[]. primaryV4Address. address	string Внутренний IPv4-адрес, назначенный виртуальной машине для этого сетевого интерфейса.
networkInterfaces[]. primaryV4Address. oneToOneNat	object Конфигурация One-to-one NAT . Если отсутствует, NAT не был настроен.
networkInterfaces[]. primaryV4Address. oneToOneNat. address	string Публичный IP-адрес, связанный с данной виртуальной машиной
networkInterfaces[]. primaryV4Address. oneToOneNat. ipVersion	string Версия IP для публичного IP-адреса. IPV4: IPv4-адрес, например 192.0.2.235. IPV6: Адрес IPv6. На данный момент не доступен.
networkInterfaces[]. primaryV6Address	object Основной IPv6-адрес, который назначен виртуальной машине для данного сетевого интерфейса. IPv6 еще не доступен.
networkInterfaces[]. primaryV6Address. address	string Внутренний IPv4-адрес, назначенный виртуальной машине для этого сетевого интерфейса.
networkInterfaces[]. primaryV6Address. oneToOneNat	object Конфигурация One-to-one NAT . Если отсутствует, NAT не был настроен.
networkInterfaces[]. primaryV6Address. oneToOneNat. address	string Публичный IP-адрес, связанный с данной виртуальной машиной
networkInterfaces[]. primaryV6Address. oneToOneNat. ipVersion	string Версия IP для публичного IP-адреса. IPV4: IPv4-адрес, например 192.0.2.235. IPV6: Адрес IPv6. На данный момент не доступен.
fqdn	string Доменное имя виртуальной машины. FQDN определяется сервером в формате `<hostname>.<region_id>.internal` при создании виртуальной машины. Если имя хоста не было указано при создании виртуальной машины, FQDN будет `<id>.auto.internal`.
schedulingPolicy	object Конфигурация политики планирования.
schedulingPolicy. preemptible	boolean (boolean) Если значение равно true — будет создана прерываемая виртуальная машина. Дополнительные сведения см. в разделе Прерываемые виртуальные машины.
serviceAccountId	string Идентификатор сервисного аккаунта для аутентификации изнутри виртуальной машины. Чтобы получить идентификатор сервисного аккаунта, используйте запрос list.

Методы

Метод	Описание
attachDisk	Присоединяет диск к виртуальной машине.
create	Создает виртуальную машину в указанном каталоге. Метод запускает асинхронную операцию, которую можно отменить перед тем, как она завершится.
delete	Удаляет указанную виртуальную машину.
detachDisk	Отсоединяет диск от виртуальной машины.
get	Возвращает указанный ресурс Instance.
getSerialPortOutput	Возвращает вывод последовательного порта указанного ресурса Instance.
list	Возвращает список доступных ресурсов Instance в указанном каталоге.
listOperations	Возвращает список операций для указанной виртуальной машины.
restart	Перезапускает работающую виртуальную машину.
start	Запускает остановленную виртуальную машину.
stop	Останавливает запущенную виртуальную машину.
update	Изменяет указанную виртуальную машину.
updateMetadata	Обновляет метаданные указанной виртуальной машины.