Получение снимков экрана

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

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

Запрос

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

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

Параметры

Получение снимков экрана

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

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

Ответы

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

200 OK

Архив со снимками экрана успешно получен.

400 Bad Request

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

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

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

Примеры ошибок: Неверный параметр 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

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

В начало