|
Параметр запроса
Параметр
|
Описание
|
Обязательный
|
id
|
Идентификатор станции.
Параметр может быть указан в запросе неограниченное количество раз для получения списков компонентов, запущенных в данный момент, для нескольких станций одновременно.
|
да
|
Пример запроса
https://192.168.1.1:9081/api/stations/running-components.ds?id=1002
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.2" timestamp="1589407134" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
<stations total="1">
<station id="1002">
<components total="7">
<component code="30" name="Dr.Web Agent for Windows" params="" started="1589403171" type="8" user="NT AUTHORITY\SYSTEM"/>
<!-- etc. Skipped in documentation -->
<component code="57" name="SpIDer Guard for Windows workstations" params="" started="1589403177" type="8" user="NT AUTHORITY\SYSTEM"/>
</components>
</station>
</stations>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <stations /> содержит список запущенных компонентов на станциях, указанных в запросе.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций в ответе
|
•Элемент <station /> содержит информацию о конкретной станции.
Атрибут элемента <station />:
Атрибут
|
Описание
|
id
|
Идентификатор станции
|
▫Элемент <components /> содержит информацию обо всех запущенных компонентах на станции.
Атрибут элемента <components />:
Атрибут
|
Описание
|
total
|
Общее количество запущенных компонентов на станции
|
•Элемент <component /> содержит информацию о конкретном запущенном компоненте.
Атрибуты элемента <component />:
Атрибут
|
Описание
|
code
|
Числовой код компонента (см. Приложение Б2. Коды компонентов)
|
name
|
Название компонента (см. Приложение Б2. Коды компонентов)
|
params
|
Параметры запуска компонента
|
started
|
Время запуска компонента
|
type
|
Способ запуска компонента:
1 — запущен вручную,
2 — запущен по расписанию,
4 — запущен пользователем,
8 — запущен как служебный процесс.
|
user
|
Пользователь станции, от имени которого был запущен компонент
|
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1589407122,
"api": {
"version": 40302,
"versionString": "4.3.2"},
"server": {
"name": "192.168.1.1",
"version": "13.00.0.202005090",
"uuid": "b35d999d-9212-481d-af8c-8551c4113383"}},
"data": {
"total": 1,
"list": [{
"components": [
{"code": 30,
"name": "Dr.Web Agent for Windows",
"params": "",
"pid": "30",
"started_time": 1589403171,
"type": 8,
"user": "NT AUTHORITY\\SYSTEM"},
...,
{"code": 57,
"name": "SpIDer Guard for Windows workstations",
"params": "",
"pid": "38",
"started_time": 1589403177,
"type": 8,
"user": "NT AUTHORITY\\SYSTEM"}],
"station_id": "1002"}]}}
|
Описание параметров ответного JSON
Блок data содержит список запущенных компонентов на станциях, указанных в запросе.
Элементы блока data:
Название поля
|
Описание
|
total
|
Общее количество станций в ответе
|
list
|
Массив с информацией обо всех запущенных компонентах для каждой станции
|
•Элементы объектов в массиве list:
Название поля
|
Описание
|
components
|
Массив с параметрами для каждого запущенного компонента на конкретной станции
|
station_id
|
Идентификатор станции
|
▫Элементы объектов в массиве components:
Название поля
|
Описание
|
code
|
Числовой код компонента (см. Приложение Б2. Коды компонентов)
|
name
|
Название компонента (см. Приложение Б2. Коды компонентов)
|
params
|
Параметры запуска компонента
|
pid
|
Идентификатор процесса на станции
|
started_time
|
Время запуска компонента
|
type
|
Способ запуска компонента:
1 — запущен вручную,
2 — запущен по расписанию,
4 — запущен пользователем,
8 — запущен как служебный процесс.
|
user
|
Пользователь станции, от имени которого был запущен компонент
|
|