Параметры запроса
Параметр
|
Описание
|
Допустимые значения
|
Обязательный
|
action-adware
|
Действие при обнаружении рекламных программ
|
•delete — удалять, •ignore — игнорировать, •quarantine — перемещать в карантин |
нет
|
action-dialers
|
Действие при обнаружении программ дозвона
|
•delete — удалять, •ignore — игнорировать, •quarantine — перемещать в карантин |
нет
|
action-hacktools
|
Действие при обнаружении программ взлома
|
•delete — удалять, •ignore — игнорировать, •quarantine — перемещать в карантин |
нет
|
action-incurable-files
|
Действие при невозможности лечения зараженного объекта
|
•delete — удалять, •quarantine — перемещать в карантин |
нет
|
action-infected-archive
|
Действие при обнаружении инфицированных архивов
|
•delete — удалять, •quarantine — перемещать в карантин |
нет
|
action-infected-boot
|
Действие при обнаружении инфицированных загрузочных секторов
|
•cure — лечить, •report — отправлять оповещение на Сервер |
нет
|
action-infected-container
|
Действие при обнаружении инфицированных файловых контейнеров
|
•delete — удалять, •quarantine — перемещать в карантин |
нет
|
action-infected-files
|
Действие при обнаружении инфицированных файлов
|
•cure — лечить, •delete — удалять, •quarantine — перемещать в карантин |
нет
|
action-infected-mail
|
Действие при обнаружении инфицированных почтовых файлов
|
•ignore — игнорировать, •quarantine — перемещать в карантин |
нет
|
action-jokes
|
Действие при обнаружении программ-шуток
|
•delete — удалять, •ignore — игнорировать, •quarantine — перемещать в карантин |
нет
|
action-riskware
|
Действие при обнаружении потенциально опасных программ
|
•delete — удалять, •ignore — игнорировать, •quarantine — перемещать в карантин |
нет
|
action-suspicious-files
|
Действие при обнаружении подозрительных файлов
|
•delete — удалять, •ignore — игнорировать, •quarantine — перемещать в карантин |
нет
|
id
|
Идентификатор станции.
Параметр может быть указан в запросе неограниченное количество раз для запуска сканирования на нескольких станциях одновременно.
|
–
|
да
|
reboot
|
Задание автоматической перезагрузки компьютера пользователя после окончания сканирования, если в процессе проверки были обнаружены инфицированные объекты, для завершения лечения которых требуется перезагрузка операционной системы
|
yes | no
|
нет
|
type
|
Тип сканирования.
По умолчанию quick
|
•full — полное сканирование, •quick — быстрое сканирование |
нет
|
Пример запроса
http://192.168.1.1:9080/api/stations/start-scanner.ds?id=d071625c-d21d-b211-9bc4-bc02713bf843&id=70200e02-d21d-b211-8a39-a00ca2f8be36
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.0" timestamp="1558521952" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
<stations total="2">
<station id="d071625c-d21d-b211-9bc4-bc02713bf843" status="initiated"/>
<station id="70200e02-d21d-b211-8a39-a00ca2f8be36" status="failed"/>
</stations>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <stations /> содержит информацию о результатах запуска сканирования на станциях.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций, на которых запускалось сканирование
|
•Элемент <station /> содержит информацию о конкретных станциях, на которых запускалось удаленное сканирование. Атрибуты элемента <station />:
Атрибут
|
Описание
|
id
|
Идентификатор станции
|
status
|
Статус запуска удаленного сканирования. Может принимать следующие значения:
•delayed — запуск сканирования отложен, •failed — запуск сканирования завершился с ошибкой, •initiated — сканирование инициировано. |
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1558522040,
"api": {
"version": 40300,
"versionString": 4.3.0},
"server": {
"name": "192.168.1.1",
"version": "12.00.0.201909260",
"uuid": "27671337-e0b0-4f60-aeb0-ab1f2ca47f77"}},
"data": {
"total": 2,
"list": {
"70200e02-d21d-b211-8a39-a00ca2f8be36": "failed",
"d071625c-d21d-b211-9bc4-bc02713bf843": "initiated"}}}
|
Описание параметров ответного JSON
Блок data содержит информацию о результатах запуска сканирования на станциях.
Элементы блока data:
Название поля
|
Описание
|
total
|
Общее количество станций, на которых запускалось сканирование
|
•Массив list содержит информацию о конкретных станциях, на которых запускалось удаленное сканирование. Элементы объектов в массиве list:
Название поля
|
Описание
|
Идентификатор станции, на которой запускалось удаленное сканирование
|
Статус процесса удаленного сканирования. Может принимать следующие значения:
•delayed — сканирование отложено, •failed — сканирование завершилось с ошибкой, •initiated — сканирование инициировано. |
|