14.3. [DKSF 48.4 IU] Управление резервированием вводов электропитания

Интерфейс URL-encoded команд в устройстве может быть использован для интеграции с web-приложениями без использования протокола SNMP. Через интерфейс URL-encoded команд доступно управление резервированием вводов электропитания.

Запрос состояния вводов

http://192.168.0.100/ats_in.cgi

Возвращаемые значения

ats_in_result('ok', 1, 1)

где:

Первый аргумент: всегда 'ok'

Второй и третий аргумент соответствуют наличию напряжения на вводах 1 и 2 соответственно:

0 – нет напряжения

1 – есть напряжение

Запрос состояния группы розеток

http://192.168.0.100/ats.cgi?gN

где:

– номер группы розеток, 1 (1..4) или 2 (5..8)

Возвращаемые значения

ats_in_result('ok', 'primary', 1)

где:

Первый аргумент: всегда 'ok'

Второй аргумент 'backup', если группа питается от резервного ввода, и 'primary', если от основного

Третий аргумент соответствуют наличию напряжения на активном вводе

0 – нет напряжения

1 – есть напряжение

Запрос настроек группы розеток

Запрос настроек определения основного ввода для групп розеток, перехода на резервный ввод при отсутствии питания на основном вводе и автовозврата групп розеток на основной ввод при появлении питания на основном вводе, соответственно:

http://192.168.0.100/ats.cgi?gN&main

http://192.168.0.100/ats.cgi?gN&backup

http://192.168.0.100/ats.cgi?gN&autorevert 

где:

N – номер группы розеток, 1 (1..4) или 2 (5..8)

Возвращаемые значения

Ошибка (неправильный формат запроса или неправильный номер реле):

ats_in_result('error')

Успешное выполнение команды:

ats_in_result('ok', 2)

ats_in_result('ok', 'on')

где:

Первый и единственный аргумент 'error', если команда не распознана, или задан неверный номер группы

Первый аргумент 'ok', если вторым следует значение запрошенного параметра

Второй аргумент - значение запрошенного параметра: 1 или 2 для номера основного ввода, 'on' или 'off' для резервирования и автовозврата

Выбор основного ввода

Для принудительного переключения задать альтернативный номер ввода:

http://192.168.0.100/ats.cgi?gN&main=n

где:

– номер группы розеток, 1 (1..4) или 2 (5..8)

n – номер ввода (1 или 2)

Возвращаемые значения

Ошибка выдаётся при неправильном формате команды, неправильном номере группы или номере ввода (больше 2):

ats_result('error')

Успешное выполнение команды:

ats_result('ok')

Включение/выключение авторезервирования

Включение ('on') или выключение ('off') автоматического перехода на резервный ввод при пропадании напряжения на основном вводе для групп розеток:

/ats.cgi?gN&backup=on

/ats.cgi?gN&backup=off 

где:

– номер группы розеток, 1 (1..4) или 2 (5..8)

Возвращаемые значения

Ошибка выдаётся при неправильном формате команды, неправильном номере группы или неправильном значении параметра backup:


ats_result('error')

Успешное выполнение команды:

ats_result('ok')

Включение/выключение автоматического возврата 

Включение ('on') или выключение ('off') автоматического возврата на основной ввод при восстановлении напряжения на нём для групп розеток:

/ats.cgi?gN&autorevert=on

/ats.cgi?gN&autorevert=off 

где:

– номер группы розеток, 1 (1..4) или 2 (5..8)

Возвращаемые значения

Ошибка выдаётся при неправильном формате команды, неправильном номере группы или неправильном значении параметра backup.

ats_result('error')

Успешное выполнение команды:

ats_result('ok')

Ручной возврат на основной ввод

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

/ats.cgi?g1&revert

/ats.cgi?g1&revert 

где:

– номер группы розеток, 1 (1..4) или 2 (5..8)

Возвращаемые значения

Ошибка выдаётся при неправильном формате команды:

ats_result('error')

Успешное выполнение команды:

ats_result('ok')

Авторизация

Для добавления в структуру URL-encoded-команды логина и пароля можно воспользоваться следующей схемой:

  • http://<имя_пользователя>:<пароль>@<хост>:<порт>/<URL‐путь>?<параметры>

где:

<имя_пользователя>:<пароль> — учетные данные для авторизации в web-интерфейсе устройства;

<хост>  IP-адрес устройства;

<порт>  порт HTTP-сервера;

<URL‐путь>?<параметры>  URL-encoded-команда.