Удаление задачи песочницы

Kaspersky Research Sandbox предоставляет API для удаления задачи песочницы.

Запрос;

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

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

Параметры

Удаление параметров задачи

Параметр

Тип данных

Вхождение

Описание

task_id

строка

Обязательно

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

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

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

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

Ответы

Конечная точка удаляет указанную задачу выполнения.

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

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

Примеры ошибок:

Задача была удалена ранее:

404. {"code":7,"message":"task deleted","meta":"task has already been deleted"}

Указанный идентификатор задачи не существует:

404. {"code":6,"message":"task not found"}

500 Internal Server Error

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

В начало