更新

描述

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.