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

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

Параметр

Описание

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

id

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

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

да

 

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

https://192.168.1.1:9081/api/stations/modules.ds?id=1001

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

 

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

<drweb-es-api api_version="4.3.2" timestamp="1580314534" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
  <stations total="1">
     <station id="1001">
        <modules total="30">
           <module name="drweb32.dll" version="7.00.46.03050" created="1587553046" modified="1587553046" hash="2e6df87878901996d4fa258705ec5524" file_size="4672776" file_owner="BUILTIN\Administrators:win7-pro-x64-ru\None @ WIN7-PRO-X64-RU"/>

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

           <module name="install-notifier.exe" version="12.5.0.08271" created="1587553023" modified="1587553023" hash="b25765c138c450be5c32f2b7ce2bffae" file_size="3177352" file_owner="BUILTIN\Administrators:win7-pro-x64-ru\None @ WIN7-PRO-X64-RU"/>
        </modules>
     </station>
  </stations>
</drweb-es-api>

 

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

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

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

Атрибут

Описание

total

Общее количество станций в ответе

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

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

Атрибут

Описание

id

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

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

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

Атрибут

Описание

total

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

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

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

Атрибут

Описание

name

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

version

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

created

Дата создания модуля

modified

Дата последнего изменения модуля

hash

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

file_size

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

file_owner

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

 

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

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

    "timestamp": 1587562330,

    "api": {
      "version": 40302,
      "versionString": "4.3.2"},

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

      "version": "13.00.0.202005090",
      "uuid": "d43ec7c0-846c-11ea-56fb-d8e582d45004"}},

"data": {
    "total": 1,

    "list": [{
      "modules": [
          {"created_time": 1587553046,

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

          "file_name": "drweb32.dll",

          "file_owner": "BUILTIN\\Administrators:win7-pro-x64-ru\\None @ WIN7-PRO-X64-RU",

          "file_size": 4672776,
          "hash": "2e6df87878901996d4fa258705ec5524",

          "modified_time": 1587553046,

          "version": "7.00.46.03050"},

          ...,

          {"created_time": 1587553023,

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

          "file_name": "install-notifier.exe",

          "file_owner": "BUILTIN\\Administrators:win7-pro-x64-ru\\None @ WIN7-PRO-X64-RU",

          "file_size": 3177352,
          "hash": "b25765c138c450be5c32f2b7ce2bffae",

          "modified_time": 1587553023,

          "version": "12.5.0.08271"}]},
      "station_id": "1001"}]}}

 

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

Блок data содержит список программных модулей на станциях, указанных в запросе.

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

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

Описание

total

Общее количество станций в ответе

list

Массив с информацией обо всех программных модулях для каждой станции

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

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

Описание

modules

Массив с параметрами для каждого программного модуля конкретной станции

station_id

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

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

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

Описание

created_time

Дата создания модуля

description

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

file_name

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

file_owner

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

file_size

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

hash

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

modified_time

Дата последнего изменения модуля

version

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