更新

描述

object trigger.update(object/array triggers)

此方法允许更新现有触发器。

此方法仅适用于 AdminSuper admin 用户类型。调用该方法的权限可在用户角色 设置中撤销。更多信息请参见用户 角色

参数

(object/array) 要更新的触发器属性。

必须为每个触发器定义 triggerid 属性,其他所有属性均为可选。 只有传入的属性会被更新,其他所有属性将保持不变。

除了标准触发器属性之外, 该方法还接受以下参数。

Parameter Type Description
dependencies array 该触发器所依赖的触发器

这些触发器必须仅定义 triggerid 属性。
tags array 触发器标签

返回值

(object)返回一个对象,其中包含 triggerids 属性下已更新的触发器的 ID.

示例

启用触发器

启用一个触发器,即将其状态设置为“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() in ui/include/classes/api/services/CTrigger.php.