Запрос на создание задачи
Для создания запроса на запуск приложения Kaspersky Anti Targeted Attack Platform используется HTTP-метод POST. Параметры команды передаются в теле запроса в формате JSON.
Синтаксис команды
curl -k --<путь к файлу TLS-сертификата> --key <путь к файлу закрытого ключа> -X POST "<URL-адрес сервера с компонентом Central Node>:<порт, по умолчанию 443>/kata/response_api/v1/<идентификатор external_system_id>/tasks/<идентификатор task_id>?sensor_id=<идентификатор sensor_id>&task_type=run_process" -H 'Content-Type: application/json' -d '
{
"task": {
"shedule": {"startNow": <true или false>},
"execCommand": "<название приложения, которую вы хотите запустить>",
"cmdLineParameters": "<дополнительные параметры запуска файла или выполнения команды>",
"workingDirectory": "<рабочая директория>"
}
}
'
При успешной обработке запроса задача на запуск приложения будет создана.
Параметры
Параметр | Тип | Описание |
|---|---|---|
| UUID | Уникальный идентификатор внешней системы, используемый для авторизации в Kaspersky Anti Targeted Attack Platform. |
| UUID | Уникальный идентификатор хоста с компонентом Endpoint Agent. |
| UUID | Уникальный идентификатор задачи. |
Пример ввода команды с параметрами
|
Ответ
HTTP-код: 200
Формат: JSON
} } }
|
Возвращаемое значение
Код возврата | Описание |
|---|---|
| Ошибка ввода параметров. |
| Требуется авторизация. |
| Задача с указанным идентификатором не найдена. |
| Внутренняя ошибка сервера. Повторите запрос позднее. |
Если вы хотите изменить параметры созданной задачи, вам требуется создать новый запрос на добавление задачи с нужными параметрами.
