Перезагрузка станций группы

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

Параметр

Описание

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

delay

Задержка перезагрузки станции в секундах.

Если параметр не передан, станция будет перезагружена с задержкой в 60 секунд.

нет

id

Идентификатор группы.

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

да

message

Сообщение пользователю в произвольной форме о причине перезагрузки

да

 

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

http://192.168.1.1:9080/api/groups/reboot.ds?id=4&message=reboot&delay=45

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

 

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

<drweb-es-api api_version="4.3.0" timestamp="1558521934" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
  <stations total="1">
     <station id="70200e02-d21d-b211-8a39-a00ca2f8be36" status="failed"/>

     <station id="2091ada3-ed5e-e611-3392-f0b9022a5484" status="initiated"/>
  </stations>
</drweb-es-api>

 

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

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

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

Атрибут

Описание

total

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

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

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

Атрибут

Описание

id

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

status

Статус процесса перезагрузки. Может принимать значения:

failed — ошибка при попытке запустить перезагрузку,

initiated — перезагрузка инициирована.

 

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

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

    "timestamp": 1558522021,

    "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",
       "2091ada3-ed5e-e611-3392-f0b9022a5484": "initiated"}}}

 

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

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

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

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

Описание

total

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

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

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

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

Описание

Идентификатор станции, для которой была запрошена перезагрузка

Статус процесса перезагрузки. Может принимать значения:

failed — ошибка при попытке запустить перезагрузку,

initiated — перезагрузка инициирована.