Образы

Образы - это объекты из которых может быть создан диск виртуального сервера.

Примечание

Существует три типа образов, но в этом разделе рассматриваются только шаблоны операционных систем и шаблоны приложений. Для снэпшотов есть свой раздел.

Запрос

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

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

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

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, который будет содержать массив с образами.

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

Параметр Значение
id уникальный идентификатор шаблона
slug уникальный читаемый идентификатор шаблона
name имя шаблона
type тип образа - distribution или application
distribution базовый образ - этот параметр определяет как будет производиться настройка
private для шаблонов ОС и приложений здесь всегда будет 0
size_gigabytes размер образа, ГБ
min_disk_size минимальный размер диска на который можно развернуть этот образ, ГБ
{
    "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,
            "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,
            "size_gigabytes": "2.4",
            "slug": "centos-7-amd64",
            "type": "distribution"
        }
    ]
}

Подсказка

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