创建触发器

描述

object trigger.create(object/array triggers)

此方法允许创建新的触发器.

此方法只适用于AdminSuper admin用户类型,调用该方法的权限可以在用户角色设置中被撤销. 前往 用户角色 以查看并了解更多信息.

参数

(object/array) 要创建的触发器.

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

参数类型描述
dependenciesarray目的触发器.

目的触发器必须存在且已定义triggerid属性.
tagsarray触发器标签 标签.

触发器表达式必须以扩展形式给出.

返回值

(object) 返回一个对象,该对象包含在 triggerids 属性下创建的触发器 ID,返回 的ID 顺序与传递的触发器的顺序相匹配.

示例

创建触发器

创建具有单个触发依赖关系的触发器.

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "trigger.create",
  4. "params": [
  5. {
  6. "description": "Processor load is too high on {HOST.NAME}",
  7. "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5",
  8. "dependencies": [
  9. {
  10. "triggerid": "17367"
  11. }
  12. ]
  13. },
  14. {
  15. "description": "Service status",
  16. "expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0",
  17. "dependencies": [
  18. {
  19. "triggerid": "17368"
  20. }
  21. ],
  22. "tags": [
  23. {
  24. "tag": "service",
  25. "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
  26. },
  27. {
  28. "tag": "error",
  29. "value": ""
  30. }
  31. ]
  32. }
  33. ],
  34. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  35. "id": 1
  36. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "triggerids": [
  5. "17369",
  6. "17370"
  7. ]
  8. },
  9. "id": 1
  10. }

源码

CTrigger::create() in ui/include/classes/api/services/CTrigger.php.