Запрос на получение списка хостов с компонентом Endpoint Agent
06 сентября 2024
ID 227251
Для создания запроса на вывод информации о хостах с компонентом Endpoint Agent используется HTTP-метод GET.
Синтаксис команды
GET "<URL-адрес сервера с компонентом Central Node>:<порт, по умолчанию 443>/kata/response_api/v1/<идентификатор external_system_id>/sensors"
При успешной обработке запроса отобразится список хостов с компонентом Endpoint Agent.
Вы можете создать запрос на вывод информации о хостах с фильтрами по IP-адресу, имени или идентификатору хоста. Вы можете указать один, несколько или все перечисленные фильтры.
При указании имени хоста вам нужно учитывать, что фильтр чувствителен к регистру символов.
GET "<URL-адрес сервера с компонентом Central Node>:<порт, по умолчанию 443>/kata/response_api/v1/<идентификатор external_system_id>/sensors?ip=<IP-адрес хоста>&host=<имя хоста>&sensor_id=<идентификатор sensor_id>"
При успешной обработке запроса отобразится информация о выбранном хосте с компонентом Endpoint Agent.
Параметры
Параметр | Тип | Описание |
---|---|---|
external_system_id | UUID | Уникальный идентификатор внешней системы, используемый для авторизации в Kaspersky Anti Targeted Attack Platform. |
sensor_id | UUID | Уникальный идентификатор хоста с компонентом Endpoint Agent. |
ip | string | IP-адрес хоста с компонентом Endpoint Agent. |
host | string | Имя хоста с компонентом Endpoint Agent. |
Пример ввода команд с параметрами
GET "https://10.10.0.22:443/kata/response_api/v1/15301050-0490-4A41-81EA-B0391CF21EF3/sensors" |
GET "https://10.10.0.22:443/kata/response_api/v1/15301050-0490-4A41-81EA-B0391CF21EF3/sensors?ip=10.16.40.243&host=host4&sensor_id=DF64838B-B518-414B-B769-2B8BE341A2F0" |
Ответ
HTTP-код: 200
Формат: JSON
|
Возвращаемое значение
Код возврата | Описание |
---|---|
400 | Требуется авторизация. |
401 | Ошибка ввода параметров. |
500, 502, 503, 504 | Внутренняя ошибка сервера. Повторите запрос позднее. |