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

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

Запрос

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

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

Параметры

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

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

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

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

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

Ответы

Конечная точка возвращает объект JSON, содержащий информацию об извлеченных файлах выполняемого упакованного объекта (контейнера).

200 OK

Информация о содержимом контейнера получена успешно.

Параметры ответа 200 OK

Параметр	Тип данных	Описание
`Zone`	строка	Уровень опасности файла (например, Red).
`Md5`	строка	MD5-хеш файла.
`Sha1`	строка	SHA1-хеш файла.
`Sha256`	строка	SHA256-хеш файла.
`Path`	строка	Имя файла и путь от корня загруженного объекта.
`Packer`	строка	Название упаковщика, использованного для упаковки загруженного объекта.
`Type`	строка	Автоматически определяемый тип файла.
`DetectionNames`	массив	Название обнаруженного объекта (например, HEUR:Exploit.Script.Blocker).

Пример ответа 200 OK:

{

"Zone": "Grey",

"MD5": "string",

"Sha1": "string",

"Sha256": "string",

"Path": "string",

"Packer": "string",

"Type": "string",

"DetectionNames": []

}

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

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

В начало