更新触发器
描述
object trigger.update(object/array triggers)
方法用于更新目前的触发器.
此方法只适用于_Admin_和_Super admin_用户类型,调用该方法的权限可以在用户角色设置中被撤销. 前往 用户角色 以查看并了解更多信息.
参数
(object/array)
需要更新的触发器属性.
triggerid
属性必须在每个应用集中已定义,其他所有属性为可选项。只有传递过去的属性会被更新,其他所有属性仍然保持不变.
除了 标准触发器属性 之外, 该方法还接受以下参数.
参数 | 类型 | 描述 |
---|---|---|
dependencies | array | 依赖触发的触发器. 触发器必须已定义 triggerid 属性. |
tags | array | 触发器 标签. |
指定的触发器表达式必须为展开式.
返回值
(object)
返回一个对象,其中包含 triggerids 属性下已更新的触发器的 ID.
示例
启用一个触发器
启用触发器,即将其状态设置为0.
请求:
{
"jsonrpc": "2.0",
"method": "trigger.update",
"params": {
"triggerid": "13938",
"status": 0
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"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": ""
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"triggerids": [
"13938"
]
},
"id": 1
}
另见
源码
CTrigger::update() in ui/include/classes/api/services/CTrigger.php.