Получение списка устанавливаемых компонентов

Параметры запроса

Параметр

Описание

Обязательный

Идентификатор станции.

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

да

В ответном документе для станций, работающих под ОС Windows, будет содержаться список устанавливаемых компонентов, а для других станций список будет пуст.

Пример запроса

http://192.168.1.1:9080/api/stations/components.ds?id=test30cc7eb2

Ниже представлены примеры ответов в формате XML и в формате JSON.

Ответ в формате XML

<drweb-es-api api_version="4.3.0" timestamp="1558521955" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
<stations total="1">
<station id="test30cc7eb2">
<components total="12" inherited="true" inherited_group_id="20e27d73-d21d-b211-a788-85419c46f0e6" inherited_group_name="Everyone">
<component code="4" name="Dr.Web Scanner for Windows" status="1"/>

Описание параметров ответного XML

Элемент <stations /> содержит информацию обо всех запрашиваемых станциях.

Атрибут элемента <stations />:

Атрибут	Описание
total	Общее количество станций, информация о которых приведена в ответе

•Элемент <station /> содержит информацию о конкретной станции.

Атрибут элемента <station />:

Атрибут	Описание
id	Идентификатор станции

▫Элемент <components /> содержит информацию обо всех устанавливаемых компонентах конкретной станции.

Атрибуты элемента <components />:

Атрибут	Описание
total	Общее количество всех компонентов
inherited	Если принимает значение true, то компоненты унаследованы от родительской группы, если false — параметры компонентов заданы индивидуально.
inherited_group_id	Идентификатор родительской группы, от которой унаследованы параметры компонентов. Если атрибут inherited принимает значение false, то значение данного атрибута будет none.
inherited_group_name	Название родительской группы, от которой унаследованы параметры компонентов. Если атрибут inherited принимает значение false, то значение данного атрибута будет none.

▪Элемент <component /> содержит информацию о конкретном устанавливаемом компоненте.

Атрибуты элемента <component />:

Атрибут

Описание

code

Числовой код компонента (см. в разделе Коды компонентов)

name

Название компонента (см. в разделе Коды компонентов)

status

Статус компонента. Может принимать одно из следующих значений:

2 — компонент должен быть установлен,

1 — компонент может быть установлен,

0 — компонент не должен быть установлен.

Ответ в формате JSON

{ "head": {
"status": true,

"timestamp": 1558522043,

"api": {
"version": 40300,
"versionString": 4.3.0},

"server": {
"name": "192.168.1.1",

"version": "12.00.0.201909260",
"uuid": "27671337-e0b0-4f60-aeb0-ab1f2ca47f77"}},

"data": {
"total": 1,

"list": [{
"components": [
{"code": 4,
"name": "Dr.Web Scanner for Windows",
"status": 1},

{"code": 14,
"name": "SpIDer Mail for Windows workstations",
"status": 1},

{"code": 38,
"name": "SpIDer Gate for Windows workstations",
"status": 1},

{"code": 54,
"name": "Dr.Web Office Control",
"status": 1},

{"code": 55,
"name": "Dr.Web Antispam",
"status": 1},

{"code": 57,
"name": "SpIDer Guard for Windows workstations",
"status": 1},

{"code": 58,
"name": "SpIDer Guard for Windows servers",
"status": 1},

{"code": 103,
"name": "Dr.Web plug-in for MS Outlook",
"status": 1},

{"code": 105,
"name": "Dr.Web Firewall",
"status": 1},

{"code": 30,
"name": "Dr.Web Agent for Windows",
"status": 2},

{"code": 37,
"name": "Dr.Web Agent Scanner for Windows",
"status": 2},

{"code": 39,
"name": "Dr.Web Agent for UNIX",
"status": 2}],

"inherited": true,

"inherited_group_id": "20e27d73-d21d-b211-a788-85419c46f0e6",

"inherited_group_name": "Everyone",
"station_id": "test30cc7eb2"}]}}

Описание параметров ответного JSON

Блок data содержит информацию обо всех запрашиваемых станциях.

Элементы блока data:

Название поля	Описание
total	Общее количество станций, информация о которых приведена в ответе

•Массив list содержит информацию о конкретных запрашиваемых станциях.

Элементы объектов в массиве list:

Название поля	Описание
inherited	Если принимает значение true, то компоненты унаследованы от родительской группы, если false — параметры компонентов заданы индивидуально.
inherited_group_id	Идентификатор родительской группы, от которой унаследованы параметры компонентов. Если атрибут inherited принимает значение false, то значение данного атрибута будет none.
inherited_group_name	Название родительской группы, от которой унаследованы параметры компонентов. Если атрибут inherited принимает значение false, то значение данного атрибута будет none.
station_id	Идентификатор станции

▫Массив components содержит информацию о устанавливаемых компонентах станции.

Элементы объектов в массиве components:

Название поля

Описание

code

Числовой код компонента (см. в разделе Коды компонентов)

name

Название компонента (см. в разделе Коды компонентов)

status

Статус компонента. Может принимать одно из следующих значений:

2 — компонент должен быть установлен,

1 — компонент может быть установлен,

0 — компонент не должен быть установлен.