Получение файлов дампа

Kaspersky Research Sandbox предоставляет API для получения архива tar.gz, содержащего файлы дампа (снимки) процесса выполнения файла и загруженных модулей.

Этот метод доступен только для объектов, которые были выполнены в среде выполнения мобильной операционной системы (Android).

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

Запрос

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

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

Параметры

Получение файлов дампа

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

Пример команды cURL: $ curl -v --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/dumps/archive' --output <tar.gz archive name> Вам будет предложено ввести пароль. Пароль не отображается во время ввода.

Ответы

Конечная точка возвращает архив tar.gz, содержащий файлы дампа.

200 OK

Архив с файлами дампа получен успешно.

400 Bad Request

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

Параметры ответа 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

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

404 Not Found

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

Пример ошибки: Параметр task_id для задачи Windows был указан для конечной точки Android: {"code":35, "message":"task section not found"}

500 Internal Server Error

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

В начало