Просмотр списка образов

Запрос

Примечание

Для получения списка образов, предназначенных для работы с GPU, необходимо в самом конце URL добавить параметр ?is_gpu=true. Также для этих образов не поддерживается разделение на типы, поэтому параметр ?type= указывать не нужно.

Для того, чтобы получить информацию о шаблонах, необходимо отправить запрос типа GET на /v1/images с указанием параметра type, например:

  • /v1/images?type=distribution - для шаблонов операционных систем;
  • /v1/images?type=application - для шаблонов приложений.
  • /v1/images?type=snapshot - для снэпшотов.
  • /v1/images?type=backup - для бэкапов.

Для шаблонов ОС:

curl \
-X GET \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
'https://api.cloudvps.reg.ru/v1/images?type=distribution'

Для приложений:

curl \
-X GET \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
'https://api.cloudvps.reg.ru/v1/images?type=application'

Ответ

В результате будет возвращён JSON, который будет содержать массив с образами.

Каждый образ содержит следующие параметры:

Параметр Значение
created_at дата создания образа
distribution базовый образ - этот параметр определяет как будет производиться настройка
id уникальный идентификатор образа
min_disk_size минимальный размер диска на который можно развернуть этот образ, ГБ
name имя образа
private для шаблонов ОС и приложений здесь всегда будет 0
region_slug уникальное читаемое имя региона
size_gigabytes размер образа, ГБ
slug уникальный читаемый идентификатор образа
type тип образа см. ниже

Тип образа может принимать следующие значения:

Тип Значение
application приложение
backup бэкап
distribution шаблон чистой ОС
snapshot снэпшот
{
    "images": [
        {
            "created_at": "2017-10-31 10:55:48",
            "distribution": "ubuntu-16.04",
            "id": 3459,
            "min_disk_size": "10",
            "name": "Ubuntu 16.04 LTS",
            "private": 0,
            "region_slug":"msk1",
            "size_gigabytes": "2.4",
            "slug": "ubuntu-16-04-amd64",
            "type": "distribution"
        },
        {
            "created_at": "2017-10-31 10:55:48",
            "distribution": "centos-7",
            "id": 3461,
            "min_disk_size": "10",
            "name": "CentOS 7",
            "private": 0,
            "region_slug":"msk1",
            "size_gigabytes": "2.4",
            "slug": "centos-7-amd64",
            "type": "distribution"
        }
    ]
}

Подсказка

Мы опустили пример для приложений, поскольку вывод идентичен