triggerprototype.update
Описание
object triggerprototype.update(объект/массив triggerPrototypes)
Этот метод позволяет обновлять существующие прототипы триггеров.
Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.
Параметры
(object/array) Свойства прототипа триггера, которые необходимо обновить.
Для каждого прототипа триггера должно быть определено свойство triggerid, все
остальные свойства необязательны. Будут обновлены только переданные свойства,
все остальные останутся без изменений.
Помимо стандартных свойств прототипа триггера метод принимает следующие параметры.
| Parameter | Type | Description |
|---|---|---|
| dependencies | array | Триггеры и прототипы триггеров, от которых зависит прототип триггера. У триггеров должно быть определено только свойство triggerid. |
| tags | array | Теги прототипа триггера. |
Возвращаемые значения
(object) Возвращает объект, содержащий идентификаторы обновленных прототипов триггеров
в свойстве triggerids.
Примеры
Включение прототипа триггера
Чтобы включить прототип триггера, установите для его статуса значение "0".
{
"jsonrpc": "2.0",
"method": "triggerprototype.update",
"params": {
"triggerid": "13938",
"status": 0
},
"id": 1
}Ответ:
{
"jsonrpc": "2.0",
"result": {
"triggerids": [
"13938"
]
},
"id": 1
}Замена тегов прототипа триггера
Заменяет теги для одного прототипа триггера.
{
"jsonrpc": "2.0",
"method": "triggerprototype.update",
"params": {
"triggerid": "17373",
"tags": [
{
"tag": "volume",
"value": "{#FSNAME}"
},
{
"tag": "type",
"value": "{#FSTYPE}"
}
]
},
"id": 1
}Ответ:
{
"jsonrpc": "2.0",
"result": {
"triggerids": [
"17373"
]
},
"id": 1
}Источник
CTriggerPrototype::update() в ui/include/classes/api/services/CTriggerPrototype.php.