Получение списка сред выполнения

Kaspersky Research Sandbox предоставляет API для получения списка доступных сред выполнения (как по умолчанию, так и пользовательских).

Запрос

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

Конечная точка: https://<server name>/api/v1/sandbox/exec_env

Параметры

Эта конечная точка не требует параметров запроса.

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

$ curl --user <user name> --request GET 'https://<server name>/api/v1/sandbox/exec_env'

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

Ответы

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

200 OK

Список сред выполнения успешно получен.

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

Параметр

Тип данных

Описание

id

строка

Имя среды выполнения для использования через API.

name

строка

Имя среды выполнения для использования через веб-интерфейс.

os_family

строка

Семейство операционных систем, на базе которых создана среда выполнения: Windows, Linux или Android.

product_activations

массив объектов

Статус активации программного обеспечения Microsoft с помощью пользовательских ключей:

  • product – название программного обеспечения.
  • activated – указывает, активировано ли программное обеспечение (true) или нет (false).

Этот параметр доступен только для образов по умолчанию.

default

логический

Указывает, какой это образ – по умолчанию (предустановленный) или пользовательский.

Доступные значения:

  • true – образ предустановлен или специально подготовлен и импортирован администратором Kaspersky Research Sandbox.
  • false – образ является пользовательским (изначально создан пользователем).

os_info

массив объектов

Общая информация об операционной системе:

  • Name – название операционной системы, например Centos 7 или Microsoft Windows 10 Pro.
  • Version – точная версия операционной системы, например 10.0.18362.
  • Bitness – разрядность операционной системы, например 32 или 64.

channel

строка

Определенный сетевой канал, указанный для среды выполнения.

Обратите внимание: если для среды выполнения указан канал, его нельзя изменить при создании задачи выполнения.

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

{

"id": "CentOS7_x64",

"name": "CentOS7_x64",

"os_family": "Linux",

"product_activations": [

{

"product": "CentOS7",

"activated": true

}

],

"default": true,

"os_info": {

"Name": "Centos 7",

"Version": "centos-release-7-8.2003.0.el7.centos_x86_64",

"Bitness": 64

},

"channel": ""

},

{

"id": "Win10_x64",

"name": "Win10_x64",

"os_family": "Windows",

"product_activations": [

{

"product": "Win10",

"activated": true

},

{

"product": "Office2016",

"activated": true

}

],

"default": true,

"os_info": {

"Name": "Microsoft Windows 10 Pro",

"Version": "10.0.18362",

"Bitness": 64

},

"channel": ""

}

400 Bad Request

Не удалось получить список сред выполнения.

401 Unauthorized

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

500 Internal Server Error

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

В начало