pdu.php¶

Модуль управления PDU (Power Distribution Unit): получение данных о потреблении энергии, проверка перегрузок и загрузка версий прошивок через SNMP.

Методы API¶

Метод	Действие	Описание
`bind`	не определено	Метод не содержит логики обработки параметров в предоставленном коде.
`check_overload`	проверка перегрузки	Запускает процесс проверки всех PDU на наличие перегрузок и фиксирует результат в журнале Jenkins.
`get`	получение данных потребления	Возвращает статистику энергопотребления (total, 5min, 2h, 24h) и список доступных SNMP-тегов для конкретного PDU.
`load_version`	загрузка версии прошивки	Запрашивает текущую версию прошивки устройства через SNMP.

Возвращает статистику энергопотребления (total, 5min, 2h, 24h) и список доступных SNMP-тегов для конкретного PDU.

HTTP-метод: POST|GET

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `get`
token	✅	string	Токен авторизации
id	✅	integer	Идентификатор PDU для получения данных потребления и SNMP-тегов

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

curl -s "https://invapi.hostkey.ru/pdu.php" -X POST \
--data "action=get" \
--data "token=HOSTKEY_TOKEN" \
--data "id=VALUE"

Пример успешного ответа

{
"result": "OK",
"data": [
{
"name": "SNMP Tag Name",
"id": 123,
"total": 45.5,
"5min": 40.2,
"2h": 42.0,
"24h": 41.5
}
]
}

Примеры ошибок

{
"code": -1,
"message": "PDU: id is required"
}

Запрашивает текущую версию прошивки устройства через SNMP.

HTTP-метод: POST|GET

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `load_version`
token	✅	string	Токен авторизации
ip	✅	string	Сетевой адрес устройства для выполнения SNMP запроса.

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

curl -s "https://invapi.hostkey.ru/pdu.php" -X POST \
--data "action=load_version" \
--data "token=VALUE" \
--data "ip=VALUE"

Пример успешного ответа

{
"result": "OK",
"id": 123,
"callback": "7bc29eb23fb1b879b21fce509597f07c"
}

Примеры ошибок

{
"code": -1,
"message": "equipment 123 has invalid IP address - 192.168.1.1"
}

Запускает процесс проверки всех PDU на наличие перегрузок и фиксирует результат в журнале Jenkins.

HTTP-метод: POST|GET

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `check_overload`
-	-	-	Других параметров нет

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

curl -s "https://invapi.hostkey.ru/pdu.php" -X POST \
--data "action=check_overload"

Пример успешного ответа

{
"result": "OK",
"module": "pdu",
"action": "check_overload"
}

Примеры ошибок

{
"code": -2,
"message": "pdu: action is required"
}

Метод не содержит логики обработки параметров в предоставленном коде.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `bind`
-	-	-	Других параметров нет

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

curl -s "https://invapi.hostkey.ru/pdu.php" -X POST \
--data "action=bind"

Пример успешного ответа

{
"result": "OK",
"action": "bind",
"data": {}
}

Примеры ошибок

{
"code": -1,
"message": "Action not found"
}