Получение информации о содержимом контейнера
16 июля 2026
ID ObtainingContainerInfoAPI
Kaspersky Research Sandbox предоставляет API для получения информации о содержимом (извлеченных файлах) выполняемого упакованного объекта (контейнера).
Запрос
Метод запроса: GET
Конечная точка: https://<server name>/api/v1/sandbox/tasks/{task ID}/container_files
Параметры
Получение информации о содержимом контейнера
Параметр | Тип данных | Вхождение | Описание |
|---|---|---|---|
| строка | Обязательно | Идентификатор задачи выполнения объекта (GUID). |
Пример команды cURL: $ curl --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/container_files' Вам будет предложено ввести пароль. Пароль не отображается во время ввода. |
Ответы
Конечная точка возвращает объект JSON, содержащий информацию об извлеченных файлах выполняемого упакованного объекта (контейнера).
200 OK
Информация о содержимом контейнера получена успешно.
Параметры ответа 200 OK
Параметр | Тип данных | Описание |
|---|---|---|
| строка | Уровень опасности файла (например, Red). |
| строка | MD5-хеш файла. |
| строка | SHA1-хеш файла. |
| строка | SHA256-хеш файла. |
| строка | Имя файла и путь от корня загруженного объекта. |
| строка | Название упаковщика, использованного для упаковки загруженного объекта. |
| строка | Автоматически определяемый тип файла. |
| массив | Название обнаруженного объекта (например, 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":6,"message":"task not found"} Неверный формат параметра {"code":29,"message":"bad task id"} |
401 Unauthorized
Не удалось получить информацию о содержимом контейнера.
404 Not Found
Задача с указанным идентификатором не найдена.
500 Internal Server Error
Не удалось получить информацию о содержимом контейнера из-за внутренней ошибки сервера.