更新

描述

object correlation.update(object/array correlations)

这个方法允许更新已存在的联系

参数

(object/array) 要更新的联系的属性。

必须为每个联系定义 correlationid 属性,其它的属性都是可选的。只有传递的属性会被更新,其它属性都将保持不变。

另外,对于标准联系属性,该方法接受以下参数。

参数 类描述
filter对象 替当前筛选的联系筛选对象。
operations数组 替已存在的操作的联系操作。

返回值

(object) 返回一个对象,该对象包含 “correlationids” 属性下更新的联系的 ID。

示例

禁用联系

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "correlation.update",
  4. "params": {
  5. "correlationid": "1",
  6. "status": "1"
  7. },
  8. "auth": "343baad4f88b4106b9b5961e77437688",
  9. "id": 1
  10. }

响应:

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

替代条件,但评估方法不变

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "correlation.update",
  4. "params": {
  5. "correlationid": "1",
  6. "filter": {
  7. "conditions": [
  8. {
  9. "type": 3,
  10. "oldtag": "error",
  11. "newtag": "ok"
  12. }
  13. ]
  14. }
  15. },
  16. "auth": "343baad4f88b4106b9b5961e77437688",
  17. "id": 1
  18. }

响应:

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

参见

来源

CCorrelation::update() in frontends/php/include/classes/api/services/CCorrelation.php.