Получение списка загрузочных образов

Получение списка загрузочных образов операционных систем, с возможностью фильтрации и постраничного вывода.

POST /v1/bootable_images/search

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

Имя Описание Обязательный Тип Пример

page

Общее количество страниц

Нет

integer

2

pageSize

Количество элементов, возвращаемых в запросе

Нет

integer

20

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

См. BootableImagesSearchRequest.

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

{
  "name": "generic x64 bios/uefi cdrom/usb",
  "imageFileName": "generic_bootdisk",
  "statuses": [
    "CREATED"
  ],
  "bootableImagesTypeIds": [
    "genericbootimage"
  ],
  "architectureIds": [
    "x86_64"
  ],
  "installationRecipeIds": [
    "a7e0ab48-f954-48c9-89bb-7f343ccb60e2"
  ],
  "bootModes": [
    "BIOS"
  ]
}

Тип контента

application/json

Ответы

Код Сообщение Тип данных / объект схемы (DTO) Пример

200

Список загрузочных образов

BootableImagePagedResponse

 
{
  "bootableImages": [
    {
      "bootableImageId": "e750fe40-5902-4e4d-9fd2-b587139946f5",
      "name": "generic x64 bios/uefi cdrom/usb",
      "bootableImageType": {
        "bootableImageTypeId": "genericbootimage",
        "name": "Универсальный загрузочный образ"
      },
      "status": "CREATED",
      "imageFileName": "generic_bootdisk",
      "description": "Универсальный ISO образ для установки на x64 машины",
      "architecture": {
        "architectureId": "x86_64",
        "name": "x86-64"
      },
      "installationRecipes": [
        {
          "installationRecipeId": "a7e0ab48-f954-48c9-89bb-7f343ccb60e2",
          "name": "План развертывания Astra"
        }
      ],
      "bootMode": "BIOS",
      "createdAt": "2024-03-18T14:53:08.865312Z",
      "createdBy": "some_user@some_domain",
      "updatedAt": "2024-03-18T14:53:08.865312Z",
      "updatedBy": "some_user@some_domain"
    }
  ],
  "meta": {}
}

400

Incorrect request params (некорректные параметры запроса)

BasicError

 
{
  "code": "validation_failed",
  "message": "createbootableImageId.imageFileName: size must be between 1 and 256"
}

401

Ошибка аутентификации

404

Объект не найден

BasicError

 
{
  "code": "object_not_found",
  "message": "string"
}

500

Internal error (внутренняя ошибка)

BasicError

 
{
  "code": "internal_error",
  "message": "string"
}