Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

trigger.update

Описание

object trigger.update(объект/массив triggers)

Этот метод позволяет обновлять существующие триггеры.

Этот метод доступен только пользователям с типом доступа Администратор и Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект/массив) Свойства триггеров, которые будут обновлены.

Свойство triggerid должно быть указано по каждому триггеру, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.

В дополнение к стандартным свойствам триггера, этот метод принимает следующие параметры.

Параметр Тип Описание
dependencies массив Триггеры, от которых обновляемый триггер зависит.

У триггеров должно быть задано свойство triggerid.
tags массив Теги триггера.

Выражение триггера необходимо указывать в раскрытой форме.

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

(объект) Возвращает объект, который содержит ID обновленных триггеров под свойством triggerids.

Примеры

Активация триггера

Активация триггера, то есть изменение его состояния на значение "0".

Запрос:

{  "jsonrpc": "2.0",  "method": "trigger.update",  "params": {  "triggerid": "13938",  "status": 0  },  "auth": "038e1d7b1735c6a5436ee9eae095879e",  "id": 1 }

Ответ:

{  "jsonrpc": "2.0",  "result": {  "triggerids": [  "13938"  ]  },  "id": 1 }

Замена тегов у триггеров

Замена тегов у триггера.

Запрос:

{  "jsonrpc": "2.0",  "method": "trigger.update",  "params": {  "triggerid": "13938",  "tags": [  {  "tag": "service",  "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"  },  {  "tag": "error",  "value": ""  }  ]  },  "auth": "038e1d7b1735c6a5436ee9eae095879e",  "id": 1 }

Ответ:

{  "jsonrpc": "2.0",  "result": {  "triggerids": [  "13938"  ]  },  "id": 1 }

Replacing dependencies

Replace dependencies for trigger.

Request:

{  "jsonrpc": "2.0",  "method": "trigger.update",  "params": {  "triggerid": "22713",  "dependencies": [  {  "triggerid": "22712"  },  {  "triggerid": "22772"  }  ]  },  "auth": "038e1d7b1735c6a5436ee9eae095879e",  "id": 1 }

Response:

{  "jsonrpc": "2.0",  "result": {  "triggerids": [  "22713"  ]  },  "id": 1 }

Источник

CTrigger::update() в ui/include/classes/api/services/CTrigger.php.