创建

描述

object correlation.create(object/array correlations)

该方法允许创建新的关联。

此方法只有 Super admin(超级管理员) 用户可用。可以在用户角色设置中撤销调用该方法的权限。更多信息请查看用户角色

参数

(object/array) 要创建的关联。

除了标准关联属性以外,此方法还接受如下参数。

参数类型说明
operations
(必需)
array创建关联的关联操作
filter
(必需)
object关联的关联过滤 对象。

返回值

(object) 返回一个对象,该对象包含correlationids 属性下创建的关联的 ID。返回的 ID 的顺序与所传递的关联的顺序相匹配。

示例

创建一个新的事件标签关联

使用具有一个条件和一个操作的评估方法 AND/OR 创建一个关联。默认情况下,这个关联将被启用。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "correlation.create",
  4. "params": {
  5. "name": "new event tag correlation",
  6. "filter": {
  7. "evaltype": 0,
  8. "conditions": [
  9. {
  10. "type": 1,
  11. "tag": "ok"
  12. }
  13. ]
  14. },
  15. "operations": [
  16. {
  17. "type": 0
  18. }
  19. ]
  20. },
  21. "auth": "343baad4f88b4106b9b5961e77437688",
  22. "id": 1
  23. }

响应:

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

使用一个自定义表达式过滤

使用自定义过滤条件创建一个关联。公式ID A 或 B 是任意选择的。条件类型为“主机组”,操作符为 “<>”。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "correlation.create",
  4. "params": {
  5. "name": "new host group correlation",
  6. "description": "a custom description",
  7. "status": 0,
  8. "filter": {
  9. "evaltype": 3,
  10. "formula": "A or B",
  11. "conditions": [
  12. {
  13. "type": 2,
  14. "operator": 1,
  15. "formulaid": "A"
  16. },
  17. {
  18. "type": 2,
  19. "operator": 1,
  20. "formulaid": "B"
  21. }
  22. ]
  23. },
  24. "operations": [
  25. {
  26. "type": 1
  27. }
  28. ]
  29. },
  30. "auth": "343baad4f88b4106b9b5961e77437688",
  31. "id": 1
  32. }

响应:

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

参见

来源

ui/include/classes/api/services/CCorrelation.php 中的 CCorrelation::create()。