Запрос на получение списка хостов Kaspersky Endpoint Agent
Для создания запроса на вывод информации о хостах с Kaspersky Endpoint Agent используется HTTP-метод GET.
Синтаксис команды
GET "<URL-адрес сервера с компонентом Central Node>:<порт, по умолчанию 443>/kata/response_api/v1/<идентификатор external_system_id>/sensors"
При успешной обработке запроса отобразится список хостов с Kaspersky Endpoint Agent.
Вы можете создать запрос на вывод информации о хостах с указанными параметрами: IP-адресом, именем или идентификатором хоста. Вы можете указать один, несколько или все параметры.
При указании имени хоста вам нужно учитывать, что фильтр чувствителен к регистру символов.
GET "<URL-адрес сервера с компонентом Central Node>:<порт, по умолчанию 443>/kata/response_api/v1/<идентификатор external_system_id>/sensors?ip=<IP-адрес хоста>&host=<имя хоста>&sensor_id=<идентификатор sensor_id>"
При успешной обработке запроса отобразится информация о выбранном хосте с Kaspersky Endpoint Agent.
Параметры
Параметр | Тип | Описание |
|---|---|---|
| UUID | Уникальный идентификатор внешней системы, используемый для авторизации в Kaspersky Anti Targeted Attack Platform. |
| UUID | Уникальный идентификатор хоста Kaspersky Endpoint Agent. |
| string | IP-адрес хоста Kaspersky Endpoint Agent. |
| string | Имя хоста Kaspersky Endpoint Agent. |
Пример ввода команд с параметрами
|
|
Возвращаемое значение
Код возврата | Описание |
|---|---|
| Операция выполнена успешно. |
| Требуется авторизация. |
| Ошибка ввода параметров. |
| Внутренняя ошибка сервера. Повторите запрос позднее. |
