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

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

Параметр

Описание

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

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

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

да

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

http://192.168.1.1:9080/api/stations/running-components.ds?id=88e984a0-6031-11e9-5b7e-f4ffebd769bf

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

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

<drweb-es-api api_version="4.3.0" timestamp="1561552048" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
<stations total="1">
<station id="88e984a0-6031-11e9-5b7e-f4ffebd769bf">
<components total="6">
<component code="14" name="SpIDer Mail for Windows workstations" params="" started="1561525662" type="8" user="NT AUTHORITY\SYSTEM"/>

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

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

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

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

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

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

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

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

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

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

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

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

Атрибут	Описание
code	Числовой код компонента (см. в разделе Коды компонентов)
name	Название компонента (см. в разделе Коды компонентов)
params	Параметры запуска компонента
started	Время запуска компонента в формате UNIX timestamp
type	Способ запуска компонента. Может принимать следующие значения: 1 — запущен вручную, 2 — запущен по расписанию, 4 — запущен пользователем, 8 — запущен как служебный процесс.
user	Пользователь станции, от имени которого был запущен компонент

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

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

"timestamp": 1561552034,

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

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

"version": "12.00.0.201909260",
"uuid": "76b05bc0-8691-11e9-63e5-7036cecd07fa"}},

"data": {
"total": 1,

"list": [{
"components": [
{"code": 14,

"name": "SpIDer Mail for Windows workstations",

"params": "",

"pid": "14",

"started_time": 1561525662,

"type": 8,
"user": "NT AUTHORITY\\SYSTEM"},

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

"params": "",

"pid": "30",

"started_time": 1561525672,

"type": 8,

"user": "NT AUTHORITY\\SYSTEM"},

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

"params": "",

"pid": "54",

"started_time": 1561525673,

"type": 8,
"user": "NT AUTHORITY\\SYSTEM"},

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

"params": "",

"pid": "57",

"started_time": 1561525674,

"type": 8,
"user": "NT AUTHORITY\\SYSTEM"},

{"code": 124,
"name": "Dr.Web Self-protection",

"params": "",

"pid": "124",

"started_time": 1561525674,

"type": 8,
"user": "NT AUTHORITY\\SYSTEM"},

{"code": 144,
"name": "Dr.Web Preventive Protection",

"params": "",

"pid": "144",

"started_time": 1561525674,

"type": 8,
"user": "NT AUTHORITY\\SYSTEM"}],
"station_id": "88e984a0-6031-11e9-5b7e-f4ffebd769bf"}]}}

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

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

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

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

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

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

Название поля	Описание
station_id	Идентификатор станции

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

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

Название поля	Описание
code	Числовой код компонента (см. в разделе Коды компонентов)
name	Название компонента (см. в разделе Коды компонентов)
params	Параметры запуска компонента)
pid	Идентификатор процесса на станции
started_time	Время запуска компонента в формате UNIX timestamp
type	Способ запуска компонента. Может принимать следующие значения: 1 — запущен вручную, 2 — запущен по расписанию, 4 — запущен пользователем, 8 — запущен как служебный процесс.
user	Пользователь станции, от имени которого был запущен компонент