searchInstallationDistros

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

POST /v1/installation_distros/search

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

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

page

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

Нет

integer

2

pageSize

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

Нет

integer

20

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

См. InstallationDistrosSearchRequest.

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

{
  "name": "Astra Linux",
  "osFamilyIds": [
    "debian","astraLinux"
  ],
  "architectureIds": [
    "x86_64"
  ],
  "osVersion": "20.04.6"
}

Тип контента

application/json

Ответы

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

200

Список установочных дистрибутивов

InstallationDistrosPagedResponse

 
{
  "installationDistros": [
    {
      "installationDistroId": "e750fe40-5902-4e4d-9fd2-b587139946f4",
      "name": "debian-bookworm-x86-84",
      "description": "Description or commentary",
      "repositoryUrl": "http://mirror.centos.org/centos-7/7/os/x86_64/",
      "kernel": "images/pxeboot/vmlinuz",
      "initrd": "images/pxeboot/initrd.img",
      "osFamily": {
        "osFamilyId": "redhat",
        "name": "Red Hat"
      },
      "architecture": {
        "architectureId": "x86_64",
        "name": "x86-64"
      },
      "osVersion": "20.04.6",
      "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": "createInstallationDistroId.displayName: size must be between 3 and 256"
}

401

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

404

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

BasicError

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

500

Внутренняя ошибка

BasicError

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