Получение списка шаблонов

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

POST /v1/templates/search

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

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

page

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

Нет

integer

2

pageSize

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

Нет

integer

20

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

См. TemplateSearchRequest.

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

{
  "name": "preseed",
  "osFamilyIds": [
    "debian"
  ],
  "templateCategoryIds": [
    "autoinstall"
  ]
}

Тип контента

application/json

Ответы

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

200

Список шаблонов

TemplatesPagedResponse

 
{
  "templates": [
    {
      "templateId": "e750fe40-5902-4e4d-9fd2-b587139946f5",
      "name": "debian-bookworm-x86-84 preseed file",
      "description": "Description or commentary",
      "osFamily": {
        "osFamilyId": "redhat",
        "name": "Red Hat"
      },
      "templateCategory": {
        "templateCategoryId": "autoinstall",
        "name": "Файл ответов"
      },
      "template": "# Preseeding only locale sets language, country and locale.\nd-i debian-installer/locale string ru_RU\n",
      "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": "createTemplateId.displayName: size must be between 3 and 256"
}

401

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

404

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

BasicError

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

500

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

BasicError

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