Cloud VDS

Список дистрибутивов

URL: /api/v1/cloud/distributions/
Метод: GET
Результат: JSON

Коды ответов

Код Описание
200 Успешный запрос

Возвращаемое значение

Дистрибутив

  • name: str - Имя дистрибутива
  • type: str - Тип дистрибутива
  • versions: Image - Версия дистрибутива

Пример запроса

curl --request GET 'https://api-ms.netangels.ru/api/v1/cloud/distributions/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Список пользовательских образов

URL: /api/v1/cloud/images/
Метод: GET
Результат: JSON

Параметры запроса

Необязательные параметры:

  • offset: int - Индекс первой строки выборки, начиная с 0
  • limit: int - Количество элементов в выборке в диапазоне от 10 до 100

Коды ответов

Код Описание
200 Успешный запрос

Возвращаемое значение

  • count: int - Количество элементов
  • entities - Список образов
    • actual_size: int - Актуальный размер
    • created: data - Дата создания
    • display_name: str - Отображаемое имя
    • distributive: str - Название дистрибутива
    • panel_version: int - Версия панели
    • progress: int - Прогресс
    • state: str - Состояние
    • task_uid: str - ID задачи
    • uid: str - Уникальный идентификатор
    • virtual_size: int - Виртуальный размер

Пример запроса

curl --request GET 'https://api-ms.netangels.ru/api/v1/cloud/images/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Получение информации по образу

URL: /api/v1/cloud/images/{uid}/
Метод: GET
Результат: JSON

Параметры запроса

Обязательные параметры:

  • uid: int - UID образа

Коды ответов

Код Описание
200 Успешный запрос

Возвращаемое значение

Пользовательский образ

  • actual_size: int - Актуальный размер
  • created: data - Дата создания
  • display_name: str - Отображаемое имя
  • distributive: str - Название дистрибутива
  • panel_version: int - Версия панели
  • progress: int - Прогресс
  • state: str - Состояние
  • task_uid: str - ID задачи
  • uid: str - Уникальный идентификатор
  • virtual_size: int - Виртуальный размер

Пример запроса

curl --request GET 'https://api-ms.netangels.ru/api/v1/cloud/images/{uid}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Изменение имени образа

URL: /api/v1/cloud/images/{uid}/
Метод: PUT
Результат: JSON

Параметры запроса

Обязательные параметры:

  • uid: int - UID образа

Параметры тела запроса

Обязательные параметры:

  • name: str - Имя образа

Коды ответов

Код Описание
200 Успешный запрос
400 Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение

Пользовательский образ

  • actual_size: int - Актуальный размер
  • created: data - Дата создания
  • display_name: str - Отображаемое имя
  • distributive: str - Название дистрибутива
  • panel_version: int - Версия панели
  • progress: int - Прогресс
  • state: str - Состояние
  • task_uid: str - ID задачи
  • uid: str - Уникальный идентификатор
  • virtual_size: int - Виртуальный размер

Пример запроса

curl --request PUT 'https://api-ms.netangels.ru/api/v1/cloud/images/{uid}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"