update_health_check
Чтобы указать настройки диагностики устройства, используйте метод unit/update_health_check.
svc=unit/update_health_check¶ms={
"itemId":<long>,
"settings":<text>
}
Параметры
В запросе должны содержаться следующие параметры:
| Параметр | Описание |
|---|---|
| itemId | ID объекта. |
| settings | JSON с параметрами настроек для диагностики устройства. См. ниже. |
Пример JSON
Ниже приведен пример JSON-объекта с параметрами настроек для диагностики устройств.
"settings": {
"low_battery": {
"period": "1h",
"unhealthy_conditions": [
{
"type": "less", // less (меньше), greater(больше), equal (равно), not_equal (не равно), unchanged (не изменяется)
"value": 20.0
}
]
},
"max_messages_last_hour": {
"period": "1m",
"unhealthy_conditions": [
{
"type": "greater", // less (меньше), greater(больше), equal (равно), not_equal (не равно), unchanged (не изменяется)
"value": 1000.0
}
]
},
"no_data": {
"period": "1d"
},
"missing_position_data": {
"period": "1m"
},
"insufficient_satellite_coverage": {
"period": "1m",
"unhealthy_conditions": [
{
"type": "less", // less (меньше), greater(больше), equal (равно), not_equal (не равно), unchanged (не изменяется)
"value": 4.0
}
]
},
"max_distance_between_messages": {
"period": "1h",
"unhealthy_conditions": [
{
"type": "greater", // less (меньше), greater(больше), equal (равно), not_equal (не равно), unchanged (не изменяется)
"value": 100000.0 // m
}
]
},
"sensor": {
"items": [
{
"id": 1, // напряжение
"period": "1m",
"unhealthy_conditions": [
{
"type": "less", // less (меньше), greater(больше), equal (равно), not_equal (не равно), unchanged (не изменяется)
"value": 12.0
},
{
"type": "greater", // less (меньше), greater(больше), equal (равно), not_equal (не равно), unchanged (не изменяется)
"value": 13.0
}
]
},
{
"id": 3, // топливо
"period": "1m",
"unhealthy_conditions": [
{
"type": "unchanged", // less (меньше), greater(больше), equal (равно), not_equal (не равно), unchanged (не изменяется)
"value": 0.0 // не парсить
}
]
},
{
"id": 2, // цифровой датчик (зажигание)
"period": "1m",
"unhealthy_conditions": [
{
"type": "equal", // equal (равно), not_equal (не равно)
"value": 0.0 // 0.0 - выкл., 1.0 - вкл.
}
]
}
]
}
}
Пример
Ниже приведен пример запроса unit/update_health_check.
svc=unit/update_health_check¶ms={
"itemId": 1583,
"settings": {
"low_battery": {
"period": "1h",
"unhealthy_conditions": [
{
"type": "less",
"value": 20.0
}
]
},
"max_messages_last_hour": {
"period": "1m",
"unhealthy_conditions": [
{
"type": "greater",
"value": 1000.0
}
]
},
"no_data": {
"period": "1d"
},
"missing_position_data": {
"period": "1m"
},
"insufficient_satellite_coverage": {
"period": "1m",
"unhealthy_conditions": [
{
"type": "less",
"value": 4.0
}
]
},
"max_distance_between_messages": {
"period": "1h",
"unhealthy_conditions": [
{
"type": "greater",
"value": 100000.0
}
]
},
"sensor": {
"items": [
{
"id": 1,
"period": "1m",
"unhealthy_conditions": [
{
"type": "less",
"value": 12.0
},
{
"type": "greater",
"value": 13.0
}
]
},
{
"id": 3,
"period": "1m",
"unhealthy_conditions": [
{
"type": "unchanged",
"value": 0.0
}
]
},
{
"id": 2,
"period": "1m",
"unhealthy_conditions": [
{
"type": "equal",
"value": 0.0
}
]
}
]
}
}
}
Возвращаемый результат
При успешном выполнении запроса возвращается пустой ответ.
{ }
Если запрос выполнить не удалось, возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Невалидные входные параметры. |
| 7 | Не подключена услуга «Диагностика устройств», или у пользователя нет права доступа ADF_ACL_ITEM_EDIT_OTHER на объект. |
| 6 | Не удалось изменить настройки диагностики устройства |