更新
描述
object trigger.update(object/array triggers)
此方法允许更新现有触发器。
此方法仅适用于 Admin 和 Super 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.