Перейти к содержанию

Образы и дистрибутивы

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

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

Коды ответов

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

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

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

  • actual_size: int – Актуальный размер
  • bootable: bool – Возможна ли загрузка с образа
  • created_at: data – Дата создания
  • display_name: str – Отображаемое имя
  • format: str – Формат образа
  • image_id: str – Уникальный идентификатор
  • state: str – Статус образа
  • virtual_size: int – Виртуальный размер

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

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

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

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

Коды ответов

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

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

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

  • actual_size: int – Актуальный размер
  • bootable: bool – Возможна ли загрузка с образа
  • created_at: data – Дата создания
  • display_name: str – Отображаемое имя
  • format: str – Формат образа
  • image_id: str – Уникальный идентификатор
  • state: str – Статус образа
  • virtual_size: int – Виртуальный размер

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

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

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

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

Коды ответов

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

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

Дистрибутив

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

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

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

Проверка на возможность загружать образы клиенту

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

Коды ответов

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

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

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

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

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

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

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

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

Коды ответов

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

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

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

  • actual_size: int – Актуальный размер
  • bootable: bool – Возможна ли загрузка с образа
  • created_at: data – Дата создания
  • display_name: str – Отображаемое имя
  • format: str – Формат образа
  • image_id: str – Уникальный идентификатор
  • state: str – Статус образа
  • virtual_size: int – Виртуальный размер

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

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

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

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

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

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

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

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

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

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

Коды ответов

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

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

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

  • actual_size: int – Актуальный размер
  • bootable: bool – Возможна ли загрузка с образа
  • created_at: data – Дата создания
  • display_name: str – Отображаемое имя
  • format: str – Формат образа
  • image_id: str – Уникальный идентификатор
  • state: str – Статус образа
  • virtual_size: int – Виртуальный размер

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

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

Удаление образа

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

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

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

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

Коды ответов

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

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

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

  • actual_size: int – Актуальный размер
  • bootable: bool – Возможна ли загрузка с образа
  • created_at: data – Дата создания
  • display_name: str – Отображаемое имя
  • format: str – Формат образа
  • image_id: str – Уникальный идентификатор
  • state: str – Статус образа
  • virtual_size: int – Виртуальный размер

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

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