trigger.update

描述

object trigger.update(object/array triggers)

此方法用于 update 现有触发器。

此方法仅对 Admin 和 Super admin 用户类型可用。调用该方法的权限可以在用户角色设置中撤销。更多信息请参见 User roles。

参数

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

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

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

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

这些触发器只能定义 triggerid 属性。
tags array 触发器标签。

返回值

(object) 返回一个 object，其中包含在 triggerids 属性下列出的已更新触发器的 ID。

示例

启用触发器

启用触发器，即将其状态设置为 "0"。

执行请求:

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

Response:

{
    "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 中。