Метод list

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

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

HTTP-запрос

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

Query-параметры

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

Ответ

HTTP Code: 200 - OK

 {
  "images": [
    {
      "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"
      }
    }
  ],
  "nextPageToken": "string"
}

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