trigger.update

Описание

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

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

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

Параметры

(object/array) Свойства триггера, которые необходимо обновить.

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

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

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

Для триггеров должно быть определено только свойство triggerid.
tags array Теги триггера.

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

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

Примеры

Включение триггера

Включите триггер, то есть установите его статус в "0".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "13938",
        "status": 0
    },
    "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": ""
            }
        ]
    },
    "id": 1
}

Ответ:

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

Замена зависимостей

Замените зависимости для триггера.

Запрос:

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

Ответ:

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

Источник

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