Получение списка программных модулей

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

Параметр

Описание

Обязательный

id

Идентификатор станции.

Параметр может быть указан в запросе неограниченное количество раз для получения списков программных модулей антивирусных компонентов для нескольких станциях одновременно.

да

 

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

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

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

 

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

<drweb-es-api api_version="4.3.0" timestamp="1561551972" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
  <stations total="1">
     <station id="88e984a0-6031-11e9-5b7e-f4ffebd769bf">
        <modules total="32">
           <module name="drweb32.dll" version="7.00.34.11020" created="1555412121" modified="1555412121" hash="6fbd6151c4a67f7439130282efb7e981" file_size="4572424" file_owner="BUILTIN\Administrators:DRWEB\Domain Users @ MT"/>

           <module name="drwupsrv.exe" version="12.0.9.04050" created="1555412105" modified="1555412105" hash="0a8ebb1e750fb47c3949ad2c944a3cc1" file_size="7768968" file_owner="BUILTIN\Administrators:DRWEB\Domain Users @ MT"/>

           <!-- etc. Skipped in documentation -->

           <module name="win-es-agent-setup.exe" version="12.0.0.05300" created="1555412107" modified="1559729074" hash="b56aff4c5f64b45122cfda03fb732076" file_size="19241504" file_owner="BUILTIN\Administrators:DRWEB\Domain Users @ MT"/>
        </modules>
     </station>
  </stations>
</drweb-es-api>

 

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

Элемент <stations /> содержит информацию обо всех запрашиваемых станциях.

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

Атрибут

Описание

total

Общее количество станций, информация о которых приведена в ответе

Элемент <station /> содержит информацию о конкретной станции.

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

Атрибут

Описание

id

Идентификатор станции

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

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

Атрибут

Описание

total

Общее количество модулей, установленных на данной станции

Элемент <module /> содержит информацию о конкретном программном модуле.

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

Атрибут

Описание

name

Название файла

version

Версия модуля

created

Дата создания модуля в формате UNIX timestamp

modified

Дата последнего изменения модуля в формате UNIX timestamp

hash

Контрольная сумма модуля

file_size

Размер файла в байтах

file_owner

Имя владельца файла

 

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

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

    "timestamp": 1561552009,

    "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": [{
      "modules": [
          {"created_time": 1555412121,

          "description": "Dr.Web Virus-Finding Engine",

          "file_name": "drweb32.dll",

          "file_owner": "BUILTIN\\Administrators:DRWEB\\Domain Users @ MT",

          "file_size": 4572424,
          "hash": "6fbd6151c4a67f7439130282efb7e981",

          "modified_time": 1555412121,

          "version": "7.00.34.11020"},

          {"created_time": 1555412105,

          "description": "Dr.Web Update",

          "file_name": "drwupsrv.exe",

          "file_owner": "BUILTIN\\Administrators:DRWEB\\Domain Users @ MT",

          "file_size": 7768968,
          "hash": "0a8ebb1e750fb47c3949ad2c944a3cc1",

          "modified_time": 1555412105,

          "version": "12.0.9.04050"},

          ...

          {"created_time": 1555412107,

          "description": "Dr.Web Agent setup",

          "file_name": "win-es-agent-setup.exe",

          "file_owner": "BUILTIN\\Administrators:DRWEB\\Domain Users @ MT",

          "file_size": 19241504,
          "hash": "b56aff4c5f64b45122cfda03fb732076",

          "modified_time": 1559729074,

          "version": "12.0.0.05300"}]},
      "station_id": "88e984a0-6031-11e9-5b7e-f4ffebd769bf"}]}}

 

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

Блок data содержит информацию обо всех запрашиваемых станциях.

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

Название поля

Описание

total

Общее количество станций, информация о которых приведена в ответе

Массив list содержит информацию о конкретных запрашиваемых станциях.

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

Название поля

Описание

station_id

Идентификатор станции

Массив modules содержит информацию обо всех программных модулях, установленных на станции.

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

Название поля

Описание

created_time

Дата создания модуля в формате UNIX timestamp

description

Описание модуля

file_name

Название файла

file_owner

Имя владельца файла

file_size

Размер файла в байтах

hash

Контрольная сумма модуля

modified_time

Дата последнего изменения модуля в формате UNIX timestamp

version

Версия модуля