Параметры запроса
Параметр
|
Описание
|
Обязательный
|
delay
|
Период задержки для перезагрузки станции в секундах.
Если параметр не передан, станция будет перезагружена с задержкой в 60 секунд.
|
нет
|
id
|
Идентификатор группы.
Параметр может быть указан в запросе неограниченное количество раз для перезагрузки станций нескольких групп одновременно.
|
да
|
message
|
Сообщение пользователю в произвольной форме о причине перезагрузки
|
да
|
Пример запроса
https://192.168.1.1:9081/api/groups/reboot.ds?id=4&message=reboot&delay=45
|
Ниже представлены примеры ответов в формате XML и в формате JSON.
Ответ в формате XML
<drweb-es-api api_version="4.3.2" timestamp="1582030316" server="192.168.1.1" srv_version="13.00.0.202005090" status="true">
<stations total="2">
<station id="1002" status="failed"/>
<station id="1003" status="initiated"/>
</stations>
</drweb-es-api>
|
Описание параметров ответного XML
Элемент <stations /> содержит информацию о запуске перезагрузки станций в группах, указанных в запросе.
Атрибут элемента <stations />:
Атрибут
|
Описание
|
total
|
Общее количество станций в ответе
|
•Элемент <station /> содержит информацию о запуске перезагрузки конкретной станции.
Атрибуты элемента <station />:
Атрибут
|
Описание
|
id
|
Идентификатор станции
|
status
|
Статус запуска перезагрузки станции:
•failed — ошибка при попытке запустить перезагрузку,
•initiated — перезагрузка инициирована. |
Ответ в формате JSON
{ "head": {
"status": true,
"timestamp": 1582030573,
"api": {
"version": 40302,
"versionString": "4.3.2"},
"server": {
"name": "192.168.1.1",
"version": "13.00.0.202005090",
"uuid": "eae1a652-96d5-48fd-9169-4788a03688b8"}},
"data": {
"total": 2,
"list": {
"1002": "failed",
"1003": "initiated"}}}
|
Описание параметров ответного JSON
Блок data содержит информацию о запуске перезагрузки станций в группах, указанных в запросе.
Элементы блока data:
Название поля
|
Описание
|
total
|
Общее количество станций в ответе
|
list
|
Блок с результатами запуска перезагрузки для каждой станции
|
•Элементы блока list:
Название поля
|
Описание
|
Идентификатор станции
|
Статус запуска перезагрузки станции:
•failed — ошибка при попытке запустить перезагрузку,
•initiated — перезагрузка инициирована. |
|