Поиск активов
GET /api/v1/assets
Информация о программном обеспечении активов из KSC не хранится в KUMA и не будет показана в ответе.
Доступ: Главный администратор, Администратор тенанта, Аналитик второго уровня, Аналитик первого уровня, Младший аналитик, Доступ к объектам НКЦКИ, Доступ к объектам КИИ.
Параметры запроса
Имя | Тип данных | Обязательный | Описание | Пример значения |
page | number | Нет | Номер страницы. Начинается с 1. Размер страницы – 250 записей. Если параметр не указан, то используется значение по умолчанию – 1. | 1 |
id | string | Нет | Идентификатор актива. Если параметр указан несколько раз, то формируется список и применяется логический оператор ИЛИ. | 00000000-0000-0000-0000-000000000000 |
tenantID | string | Нет | Идентификатор тенанта актива. Если параметр указан несколько раз, то формируется список и применяется логический оператор ИЛИ. Если пользователь не имеет необходимой роли в указанном тенанте, то данный тенант игнорируется. | 00000000-0000-0000-0000-000000000000 |
name | string | Нет | Название актива. Регистронезависимое регулярное выражение (PCRE). | asset ^My asset$ |
fqdn | string | Нет | FQDN актива. Регистронезависимое регулярное выражение (PCRE). | ^com$ example.com |
ip | string | Нет | IP-адрес актива. Регистронезависимое регулярное выражение (PCRE). | 10.10 ^192.168.1.2$ |
mac | string | Нет | MAC-адрес актива. Регистронезависимое регулярное выражение (PCRE). | ^00:0a:95:9d:68:16$ |
Ответ
HTTP-код: 200
Формат: JSON
|
Возможные ошибки
HTTP-код | Описание | Значение поля message | Значение поля details |
400 | Неверное значение параметра page | invalid query parameter value | page |
500 | Любые другие внутренние ошибки | вариативное | вариативное |