Получение отчета об отладке

Kaspersky Research Sandbox предоставляет API для получения отчета об отладке для выполненного файла в виде архива .zip. Отчет об отладке создается, если указать debug_report=true при создании или повторном выполнении задачи песочницы.

Диагностическая информация о производительности приложения получается отдельно.

Перед выполнением этого запроса убедитесь, что требуемая задача не удалена.
В команде cURL используйте подробный режим (-v).
В случае ошибки запроса архив tar.gz будет пустым с простым текстовым файлом, содержащим сообщение об ошибке.

Запрос

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

Конечная точка: https://<server name>/api/v1/sandbox/tasks/{task_id}/debug_report

Параметры

Параметры получения отчета об отладке

Параметр	Тип данных	Вхождение	Описание
`task_id`	строка	Обязательно	Идентификатор задачи выполнения объекта (GUID).

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

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

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

Ответы

Конечная точка возвращает архив .zip, содержащий отчет об отладке для указанной задачи выполнения.

200 OK

Архив, содержащий файл отчета об отладке, успешно получен.

Архив .zip содержит следующие файлы:

internal_tracing.zip;
network.pcap;
report.zip;
https_report.zip;
ids_output.json.

400 Bad Request

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

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

Параметр	Тип данных	Описание
`code`	строка	Идентификатор ошибки.
`message`	строка	Описание ошибки.
`meta`	строка	Дополнительная информация, если таковая имеется.

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

Параметр debug_report не был указан при создании задачи:

{ "code": 4,"message": "task artifacts disabled for this task"}

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

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

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

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

401 Unauthorized

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

404 Not Found

Задача с указанным идентификатором не найдена.

500 Internal Server Error

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

В начало