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.