trigger.update

Описание

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

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

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

Параметры

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

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

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

Parameter Type Description
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.