Request Parameters
Parameter
|
Description
|
Mandatory
|
id
|
Station identifier.
This parameter can be defined in the request several times to get installed components lists for several stations at a time.
|
yes
|
Request Example
http://192.168.1.1:9080/api/stations/installed-components.ds?id=30cc7eb2-d11d-b211-b695-b80815e63511
Response Documents Structure
•XML response. •JSON response. XML Response Structure
<drweb-avdesk-api api_version="4.1.3" timestamp="1401789582" server="192.168.1.1" srv_version="10.01.0.201707130" status="true">
<stations total="1">
<station id="30cc7eb2-d11d-b211-b695-b80815e63511">
<components total="4">
<component code="30" name="Dr.Web Agent for Windows" installed="1401815761" path="C:\Program Files\DrWeb" server=""/>
<component code="124" name="Dr.Web Self-protection" installed="1401815761" path="C:\Windows\system32\drivers\" server=""/>
<component code="4" name="Dr.Web Scanner for Windows" installed="1401816853" path="C:\Program Files\DrWeb" server=""/>
<component code="57" name="SpIDer Guard for Windows workstations" installed="1401816851" path="C:\Windows\system32\drivers\" server=""/>
</components>
</station>
</stations>
</drweb-avdesk-api>
|
Description of XML Response Parameters:
•The <stations /> element contains information on all requested stations. The <stations /> element attributes:
Attribute
|
Description
|
total
|
Total number of stations information on which the replay contains
|
▫The <station /> element contains information on a specific station. The <station /> element attributes:
Attribute
|
Description
|
id
|
Station identifier
|
•The <components /> element contains information on all installed components of a specific station. The <components /> element attributes:
Attribute
|
Description
|
total
|
Total number of components installed on this station
|
inherited
|
If its value is set to true, then component parameters are inherited from a parent group, and if set to false—then component parameters are configured individually.
|
inherited_group_id
|
ID of a parent group from which component parameters have been inherited. If the inherited attribute is set to false, then this attribute value will be none.
|
inherited_group_name
|
Name of a parent group from which component parameters have been inherited. If the inherited attribute is set to false, then this attribute value will be none.
|
▫The <component /> element contains information about a specific installed component. The <component /> element attributes:
Attribute
|
Description
|
code
|
Digital code of the component. See the Component codes section.
|
name
|
Component name. See the Component codes section.
|
installed
|
Date of the component installation in the UNIX timestamp format
|
path
|
Component installation path
|
server
|
Address of the Server from which the component was installed. For components installed from the current Server, the server attribute contains the empty value.
|
JSON Response Structure
{ "head": {
"status": true,
"timestamp":1410515504,
"api":{
"version":40103
},
"server":{
"name":"192.168.1.1",
"version":1000201707130,
"uuid": "70c5f522-aaab-4c93-a180-a442a0da9c2a"
}
},
"data":{
"total": 1,
"list": [{
"components":[{
"path":"C:\\Program Files\\DrWeb",
"name":"Dr.Web Agent for Windows",
"code":30,
"installed_time":1410541641,
"server":"tcp/192.168.1.1:2193"
},{
"path":"C:\\Windows\\system32\\drivers\\",
"name":"Dr.Web Self-protection",
"code":124,
"installed_time":1410541645,
"server":"tcp/192.168.10.93:2193"
},{
"path":"C:\\Program Files\\DrWeb",
"name":"SpIDer Gate for Windows workstations",
"code":38,
"installed_time":1410541643,
"server":"tcp/192.168.1.1:2193"
}],
"station_id":"if"
}]
}
}
|
Description of JSON Response Parameters
The data block contains information on stations.
The data block elements:
Field name
|
Description
|
total
|
Total number of stations information on which the replay contains
|
•The list array contains information on specific stations. Elements in the list array:
Field name
|
Description
|
station_id
|
Station Identifier
|
•The components array contains information on all installed components of a station. Elements in the components array block:
Field name
|
Description
|
path
|
Component installation path
|
name
|
Component name. See the Component codes section.
|
code
|
Digital code of the component. See the Component codes section.
|
installed_time
|
Date of the component installation in the UNIX timestamp format
|
server
|
Address of the Server from which the component was installed. For components installed from the current Server, the server attribute contains the empty value.
|
|