Get Running Components List

Request Parameters

Parameter

Description

Obligatory

id

Station identifier.

This parameter can be defined in the request several times to get the lists of currently running components for several stations at a time.

yes

 

Request Example

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

XML and JSON response structure examples are described below.

 

XML Response

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

           <component code="30" name="Dr.Web Agent for Windows" params="" started="1561525672" type="8" user="NT AUTHORITY\SYSTEM"/>

           <component code="54" name="Dr.Web Office Control" params="" started="1561525673" type="8" user="NT AUTHORITY\SYSTEM"/>

           <component code="57" name="SpIDer Guard for Windows workstations" params="" started="1561525674" type="8" user="NT AUTHORITY\SYSTEM"/>

           <component code="124" name="Dr.Web Self-protection" params="" started="1561525674" type="8" user="NT AUTHORITY\SYSTEM"/>

           <component code="144" name="Dr.Web Preventive Protection" params="" started="1561525674" type="8" user="NT AUTHORITY\SYSTEM"/>
        </components>
     </station>
  </stations>
</drweb-es-api>

 

Description of XML Response Parameters

The <stations /> element contains information on all requested stations.

The <stations /> element attribute:

Attribute

Description

total

Total number of stations information on which is displayed in response

The <station /> element contains information on a specific station.

The <station /> element attribute:

Attribute

Description

id

Station identifier

The <components /> element contains information on all currently running components of a specific station.

The <components /> element attribute:

Attribute

Description

total

Total number of components which are running on this stations

The <component /> element contains information about a specific running component.

The <component /> element attributes:

Attribute

Description

code

Digital code of the component (see the Component codes section)

name

Name of the component (see the Component codes section)

params

Component start parameters

started

Component start time in the UNIX timestamp format

type

Component starting method. May take the following values:

1—started manually,

2—started by a scheduled task,

4—started by the user,

8—started as system process.

user

Station user on behalf of which the component was launched

 

JSON Response

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

 

Description of JSON Response Parameters

The data block contains information on all requested stations.

The data block elements:

Field name

Description

total

Total number of stations information on which is displayed in response

The list array contains information on all requested stations.

Elements in the list array:

Field name

Description

station_id

Station identifier

The components block contains information on all currently running components of a station.

Elements in the components array:

Field name

Description

code

Digital code of the component (see the Component codes section)

name

Name of the component (see the Component codes section)

params

Component start parameters

pid

Process identifier at the station

started_time

Component start time in the UNIX timestamp format

type

Component starting method. May take the following values:

1—started manually,

2—started by a scheduled task,

4—started by the user,

8—started as system process.

user

Station user on behalf of which the component was launched