Получение файла Suricata

Kaspersky Research Sandbox предоставляет API для получения пользовательского (загруженного пользователем) файла правил Suricata для указанной задачи.

Запрос

Метод запроса: GET

Конечная точка: https://<server name>/api/v1/sandbox/tasks/<task ID>/suricata

Параметры

Параметры получения пользовательского файла Suricata

Параметр

Тип данных

Вхождение

Description

task_id

строка

Обязательно

Идентификатор задачи выполнения объекта (GUID).

Пример команды cURL:

$ curl --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/suricata'

Вам будет предложено ввести пароль. Пароль не отображается во время ввода.

Ответы

Конечная точка возвращает пользовательский файл Suricata.

200 OK

Пользовательский файл Suricata успешно получен.

400 Bad Request

Не удалось получить файл Suricata из-за неверного запроса.

Параметры ответа 400 Bad Request

Параметр

Тип данных

Description

code

строка

Идентификатор ошибки.

message

строка

Описание ошибки.

meta

строка

Дополнительная информация, если таковая имеется.

Примеры ошибок:

Неверный параметр task_id:

{"code":6,"message":"task not found"}

Неверный формат параметра task_id:

{"code":29,"message":"bad task id"}

401 Unauthorized

Не удалось получить пользовательский файл Suricata из-за неверных учетных данных пользователя.

404 Not Found

Указанная задача не найдена или не содержит пользовательского файла Suricata.

500 Internal Server Error

Не удалось получить пользовательский файл Suricata из-за внутренней ошибки сервера.

В начало