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

Запрос¶

Для того, чтобы получить информацию о шаблонах, необходимо отправить запрос типа 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	тип образа см. ниже
isp_license_size	тип тарифа лицензии ISPmanager

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

Тип	Значение
application	приложение
backup	бэкап
distribution	шаблон чистой ОС
snapshot	снэпшот

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

Статус	Значение
isp_lite5	до 10 доменов
isp_lite6	до 10 доменов
isp_pro6	от 10 до 50 доменов
isp_host6	неограниченное число доменов

{
    "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"
        }
    ]
}

Подсказка

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