Получение файла манифеста пользовательского образа

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

Запрос

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

Конечная точка: https://<server name>/api/v1/sandbox/images/{id}/manifest

Параметры

Параметры получения файла манифеста пользовательского образа

Параметр

Тип данных

Вхождение

Описание

id

целое число

Обязательно

Идентификатор шаблона, который не удалось развернуть и для которого вы хотите получить файл манифеста.

Чтобы получить идентификаторы шаблонов, выполните запрос GET https://<server name>/api/v1/sandbox/images. Этот метод возвращает информацию о доступных пользовательских образах. Используйте значение поля id в качестве параметра запроса.

Также можно использовать идентификатор пользовательского образа из сообщения об ошибке в качестве значения параметра id.

manifest file name

строка

Обязательно

Имя файла манифеста для сохранения результатов (например, manifest.txt).

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

$ curl --http1.1 -X GET -u <user name> https://<server name>/api/v1/sandbox/images/<id>/manifest --output <manifest file name>

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

Ответы

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

200 OK

Файл манифеста пользовательского образа загружен.

400 Bad Request

Неверно указан идентификатор пользовательского образа. Введите правильный идентификатор.

401 Unauthorized

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

404 Not Found

Указанный пользовательский образ еще не развернут, и файл манифеста не существует. Сначала разверните шаблон.

414 Request URI Too Long

Не удалось получить файл манифеста пользовательского образа, так как URL слишком длинный для обработки сервером.

500 Internal Server Error

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

В начало