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

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

Параметр

Описание

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

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.1.202310121" 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.1.202310121",

      "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

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