Получение содержимого контейнера

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

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

Запрос

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

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

Параметры

Получение содержимого контейнера

Параметр

Тип данных

Вхождение

Description

task_id

строка

Обязательно

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

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

$ curl -v --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/container_files/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

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

500 Internal Server Error

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

В начало