Метод get

HTTP-запрос
Path-параметры
Ответ

Возвращает указанный ресурс Image.

Чтобы получить список доступных ресурсов Image, используйте запрос list.

HTTP-запрос

GET https://compute.api.cloud.yandex.net/compute/v1/images/{imageId}

Path-параметры

Параметр	Описание
imageId	Обязательное поле. Идентификатор возвращаемого ресурса Image. Чтобы получить идентификатор образа, используйте запрос list. Максимальная длина строки в символах — 50.

Ответ

HTTP Code: 200 - OK

{
  "id": "string",
  "folderId": "string",
  "createdAt": "string",
  "name": "string",
  "description": "string",
  "labels": "object",
  "family": "string",
  "storageSize": "string",
  "minDiskSize": "string",
  "productIds": [
    "string"
  ],
  "status": "string",
  "os": {
    "type": "string"
  }
}

Ресурс Image.

Поле	Описание
id	string Идентификатор образа.
folderId	string Идентификатор каталога, которому принадлежит образ диска.
createdAt	string (date-time) Строка в формате RFC3339.
name	string Имя образа. Длина 1-63 символов.
description	string Описание образа. Длина описания должна быть от 0 до 256 символов.
labels	object Метки ресурса в формате `ключ:значение`. Максимум 64 на ресурс.
family	string Имя семейства образов, к которому принадлежит этот образ. Вы можете получить самый последний образ из семейства образов, используя запрос getLatestByFamily, чтобы создать диск из этого образа.
storageSize	string (int64) Размер образа в байтах.
minDiskSize	string (int64) Минимальный размер диска, который будет создан из этого образа.
productIds[]	string Идентификаторы лицензий, указывающие, какие лицензии подключены к этому ресурсу. Идентификаторы лицензий используются для расчета дополнительной платы за использование виртуальной машины. Правильный идентификатор лицензии генерируется Яндекс.Облаком. Идентификаторы наследуются новыми ресурсами, созданными из этого ресурса. Если вам известны идентификаторы лицензий, укажите их при создании образа. Например, если создать образ диска с помощью сторонней утилиты и загрузить его в Yandex Object Storage, то идентификаторы лицензий будут потеряны. Вы можете указать их в запросе create.
status	string Текущий статус образа диска. CREATING: Образ диска создается. READY: Образ диска готов к использованию. ERROR: С образом произошла ошибка, блокирующая работу. DELETING: Образ диска удаляется.
os	object Операционная система, содержащаяся в образе.
os. type	string Тип операционной системы. Значение по умолчанию — `LINUX`. Это поле используется для правильной эмуляции vCPU и расчета стоимости использования виртуальной машины. LINUX: Операционная система Linux. WINDOWS: Операционная система Windows.