Image

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

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

{
  "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"
  }
}
Поле Описание
id string

Идентификатор образа.

folderId string

Идентификатор каталога, которому принадлежит образ диска.

createdAt string (date-time)

Строка в формате RFC3339.

name string

Имя образа. Длина 1-63 символов.

description string

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

labels object

Метки ресурса в формате key:value. Максимум 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.

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

  • LINUX: Операционная система Linux.
  • WINDOWS: Операционная система Windows.

Методы

Метод Описание
create Создает образ в указанном каталоге.
delete Удаляет указанный образ.
get Возвращает указанный ресурс Image.
getLatestByFamily Возвращает последний образ из указанного семейства образов.
list Возвращает список доступных ресурсов Image в указанном каталоге.
listOperations Список операций для указанного образа.
update Изменяет указанный образ.