trigger.update

描述

object trigger.update(object/array triggers)

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

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

参数

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

每个触发器必须定义 triggerid 属性,所有其他属性是可选的。仅传递的属性将被更新,其余属性将保持不变。

除了 触发器 外,该方法还接受以下参数。

参数 数据类型 描述
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 中。