Get the List of Stations of a Group

Request Parameters

Parameter	Description	Obligatory
id	Group identifier. Response contains information on all stations of this group (without nesting). Information on stations of the Operating system, Status, or Ungrouped system groups can be provided in the same way.	yes
page	The page number in paged view (may be used to display information about the large number of stations)	no
per-page	Number of stations per one page in paged view (may be used to display information about the large number of stations)	no
server-id	Server identifier from which the information is requested	no

Request Example

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

XML and JSON response structure examples are described below.

XML Response

<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=""/>

Description of XML Response Parameters

•The <stations /> element contains information on stations included to the specified group.

The <stations /> element attribute:

Attribute	Description
total	Total number of stations included into the specified group

▫The <station /> element contains information on specific stations of specified group.

The <station /> element attributes:

Attribute	Description
id	Station ID
name	Station name
last_seen_time	Time of last connection to the Server
last_seen_addr	Address from which the station connected to the Server at the last time
state	The current state of the station (see Returned station state codes)
os	Operating system code
os_name	Operating system name
login_addr	Station IP address
login_mac	MAC address of the station's network interface

•The <pages /> element contains information on displayed pages.

The <pages /> element attributes:

Attribute	Description
total	Total number of pages
current	Number of the current page
objects-per-page	Number of records on one page

JSON Response

{ "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}]}}}

Description of JSON Response Parameters

•The pages block contains information on the number of displayed objects.

The pages block elements:

Field name	Description
current	Number of the current page
objects_per_page	Number of records on one page
total	Total number of pages

•The stations block contains information on all stations of a requested group.

The stations block elements:

Field name	Description
total	Total number of stations included into the specified group

▫The list array contains information on specific stations of specified group.

Elements in the list array:

Field name	Description
id	Station identifier
last_seen_addr	Address from which the station connected to the Server at the last time
last_seen_time	Time of last connection to the Server
login_addr	Station IP address
login_mac	MAC address of the station's network interface
name	Station name
os	Operating system code
os_name	Operating system name
state	The current state of the station (see Returned station state codes)