Получение списка станций группы

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

Параметр	Описание	Обязательный
id	Идентификатор группы. В ответе возвращается информация обо всех станциях заданной группы (без учета вложенности). Возможно получение списка станций для системных групп Operating system, Status, Ungrouped.	да
page	Номер страницы при постраничном отображении (может использоваться для вывода информации о большом количестве станций)	нет
per-page	Количество станций на одной странице при постраничном отображении (может использоваться для вывода информации о большом количестве станций)	нет
server-id	Идентификатор Сервера, информация с которого запрашивается	нет

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

http://192.168.1.1:9080/api/groups/stations-list.ds?id=1

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

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

<drweb-es-api api_version="4.3.0" timestamp="1558521888" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
<stations total="2">
<station id="203fe068-d21d-b211-ac5b-840701ce1bdd" name="203fe068-d21d-b211-ac5b-840701ce1bdd" last_seen_time="0" last_seen_addr="" state="0" os="0" os_name="unknown" login_addr="" login_mac=""/>

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

•Элемент <stations /> содержит информацию о станциях, входящих в заданную группу.

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

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

▫Элемент <station /> содержит информацию о конкретных станциях заданной группы.

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

Атрибут	Описание
id	Идентификатор станции
name	Имя станции
last_seen_time	Время последнего подключения к Серверу
last_seen_addr	Адрес, с которого станция последний раз подключалась к Серверу
state	Текущее состояние станции (см. в разделе Возвращаемые коды состояния станции)
os	Код операционной системы
os_name	Название операционной системы
login_addr	IP-адрес станции
login_mac	MAC-адрес сетевого интерфейса станции

•Элемент <pages /> содержит информацию о выводимых страницах.

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

Атрибут	Описание
total	Общее количество страниц
current	Номер текущей страницы
objects-per-page	Количество записей на одной странице

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

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

"timestamp": 1395731278,

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

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

"version": "12.00.0.201909260",
"uuid": "1023dcd7-d11d-b211-896d-8804c0842edb"}},

"data": {
"pages": {
"current": 1,
"objects_per_page": 100,

"total": 1},

"stations": {
"total": 2,

"list": [
{"id": "203fe068-d21d-b211-ac5b-840701ce1bdd",
"last_seen_time": 0,

"last_seen_addr": null,

"login_addr": null,
"login_mac": null,

"name": "203fe068-d21d-b211-ac5b-840701ce1bdd",

"os_code": 0,

"os_name": "unknown",

"state": 0},

{"id": "2091ada3-ed5e-e611-3392-f0b9022a5484",
"last_seen_time": 1489567785,

"last_seen_addr": "tcp://192.168.233.131:49285",

"login_addr": null,
"login_mac": null,

"name": "WIN-7-PRO-SP1-X",

"os_code": 35850247,

"os_name": "Windows 7 Professional x64",

"state": 0}]}}}

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

•Блок pages содержит информацию о количестве выводимых записей.

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

Название поля	Описание
current	Номер текущей страницы
objects_per_page	Количество записей на одной странице
total	Общее количество страниц

•Блок stations содержит информацию обо всех станциях заданной группы.

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

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

▫Массив list содержит информацию обо всех станциях заданной группы.

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

Название поля	Описание
id	Идентификатор станции
last_seen_addr	Адрес, с которого станция последний раз подключалась к Серверу
last_seen_time	Время последнего подключения к Серверу
login_addr	IP-адрес станции
login_mac	MAC-адрес сетевого интерфейса станции
name	Имя станции
os	Код операционной системы
os_name	Название операционной системы
state	Текущее состояние станции (см. в разделе Возвращаемые коды состояния станции)