update_notification
Функция update_notification используется для создания, редактирования или удаления уведомлений.
svc=resource/update_notification¶ms={"itemId":<long>,
"id":<long>, /* ID уведомления */
"callMode":"<text>",
"e":<uint>,
"n":"<text>", /* имя */
"txt":"<text>", /* текст уведомления */
"ta":<uint>, /* время активации (формат Unix) */
"td":<uint>, /* время деактивации (формат Unix) */
"ma":<uint>, /* максимальное количество срабатываний (0 — не ограничено) */
"mmtd":<uint>, /* максимальный временнóй интервал между сообщениями, сек. */
"cdt":<uint>, /* таймаут срабатывания, сек. */
"mast":<uint>, /* минимальная продолжительность тревожного состояния, сек. */
"mpst":<uint>, /* минимальная продолжительность предыдущего состояния, сек. */
"cp":<uint>, /* период контроля относительно текущего времени, сек. */
"fl":<uint>, /* флаги уведомления (см. ниже) */
"tz":<int>, /* временнáя зона */
"la":"<text>", /* язык пользователя (двухбуквенный код) */
"un":[<long>], /* массив ID объектов/групп объектов */
"sch":{ /* массив ID объектов/групп объектов */
"f1":<uint>, /* начало интервала 1 (количество минут от полуночи) */
"f2":<uint>, /* начало интервала 2 (количество минут от полуночи) */
"t1":<uint>, /* конец интервала 1 (количество минут от полуночи) */
"t2":<uint>, /* конец интервала 2 (количество минут от полуночи) */
"m":<uint>, /* маска дней месяца [1: 2||0, 31: 2||30] */
"y":<uint>, /* маска месяцев [Jan: 2||0, Dec: 2||11] */
"w":<uint> /* маска дней недели [Mon: 2||0, Sun: 2||6] */
},
"ctrl_sch":{ /* расписание максимального количества интервалов срабатывания */
"f1":<uint>, /* начало интервала 1 (количество минут от полуночи) */
"f2":<uint>, /* начало интервала 2 (количество минут от полуночи) */
"t1":<uint>, /* конец интервала 1 (количество минут от полуночи) */
"t2":<uint>, /* конец интервала 2 (количество минут от полуночи) */
"m":<uint>, /* конец интервала 2 (количество минут от полуночи) */
"y":<uint>, /* маска месяцев [Jan: 2||0, Dec: 2||11] */
"w":<uint> /* маска дней недели [Mon: 2||0, Sun: 2||6] */
},
"trg":{ /* контроль */
"t":"<text>", /* тип контроля (см. ниже) */
"p":{ /* параметры */
"<text>":"<text>", /* название параметра: значение */
...
}
},
"act":[ /* действия */
{
"t":"<text>", /* тип действия (см. ниже) */
"p":{ /* параметры */
"<text>":"<text>", /* название параметра: значение */
...
}
}
]}
Смотрите описание флагов уведомлений, типов действий и типов контроля на странице get_notification_data.
Для уведомления с типом контроля Простой значение параметра mast в секундах должно соответствовать параметру min_idle_time в минутах. Например, чтобы уведомление срабатывало после 10 минут простоя, укажите 10 в параметре min_idle_time и 600 в mast.
Параметры
Название | Описание |
---|---|
itemId | ID ресурса. |
id | ID уведомления (0 — создать). |
callMode | Действие: создание, редактирование, удаление, включение/отключение (create, edit, delete, enable). |
e | Используется только для действия включения/отключения (enable):
|
Другие параметры необходимы только для создания и редактирования. См. страницу get_notification_data.
Возвращаемый результат
Для запросов, связанных с созданием и редактированием:
[
<long>, /* ID уведомления */
{
"id":<long>, /* ID уведомления */
"n":"<text>", /* имя */
"txt":"<text>", /* текст уведомления */
"ta":<uint>, /* время активации (формат Unix) */
"td":<uint>, /* время деактивации (формат Unix) */
"ma":<uint>, /* максимальное количество срабатываний (0 — не ограничено) */
"fl":<uint>, /* флаги уведомлений */
"ac":<uint>, /* количество срабатываний */
"un":[<long>], /* массив ID объектов/групп объектов */
"act":["<text>"], /* действия */
"trg":"<text>", /* тип контроля */
"trg_p":{}, /* настройки контроля */
"crc":<long>, /* контрольная сумма бинарного представления уведомления */
"ct":<uint>, /* время создания */
"mt":<uint> /* время последнего изменения */
}
]
Флаги уведомлений, типы действий и контроля описаны здесь.
Для запросов, связанных с удалением:
[
<long>, /* ID уведомления */
null
]
Возможные коды ошибок:
Код | Описание |
---|---|
7 | Не удалось извлечь ресурс с требуемым ACL (ADF_ACL_AVL_RES_EDIT_NF). |
6 | Неопределенная ошибка. |
4 | Неверные входные параметры. |