以下objects与correlation API直接相关。
关联
关联object具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| correlationid | string | (只读) 关联的ID。 |
| name (required) |
string | 关联的名称。 |
| description | string | 关联的描述。 |
| status | integer | 关联是否启用或禁用。 可能的值为： 0 - (默认) 启用； 1 - 禁用。 |
请注意，某些方法（更新、删除）所需/可选参数的组合有所不同。
关联操作
关联操作object定义了在关联执行时将执行的操作。它具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| type (required) |
integer | 操作类型。 可能的值： 0 - 关闭旧事件； 1 - 关闭新事件。 |
关联过滤器
关联过滤器object定义了执行配置关联操作时必须满足的一组条件。它具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| evaltype (required) |
integer | 过滤条件评估方法。 可选值： 0 - 与/或； 1 - 与； 2 - 或； 3 - 自定义表达式。 |
| conditions (required) |
array | 用于过滤结果的过滤条件集合。 |
| eval_formula | string | (只读) 用于评估过滤条件的生成表达式。该表达式包含通过formulaid引用特定过滤条件的ID。对于自定义表达式过滤器，eval_formula的值等于formula的值。 |
| formula | string | 用于评估自定义表达式过滤器条件的用户定义表达式。该表达式必须包含通过formulaid引用特定过滤条件的ID。表达式中使用的ID必须与过滤条件中定义的ID完全匹配：不能有任何条件未被使用或遗漏。自定义表达式过滤器必需。 |
关联过滤条件
关联过滤器条件object定义了在执行关联操作前必须检查的特定条件。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| type (required) |
integer | 条件类型。 可选值： 0 - 旧事件标签； 1 - 新事件标签； 2 - 新事件主机分组； 3 - 事件标签对； 4 - 旧事件标签值； 5 - 新事件标签值。 |
| tag | string | 事件标签（旧或新）。当条件类型为以下值时必需：0、1、4、5。 |
| groupid | string | 主机分组ID。当条件类型为以下值时必需：2。 |
| oldtag | string | 旧事件标签。当条件类型为以下值时必需：3。 |
| newtag | string | 新事件标签。当条件类型为以下值时必需：3。 |
| value | string | 事件标签（旧或新）值。当条件类型为以下值时必需：4、5。 |
| formulaid | string | 用于从自定义表达式引用该条件的任意唯一ID。只能包含大写字母。修改过滤条件时必须由用户定义该ID，但在后续请求时会重新生成。 |
| operator | integer | 条件运算符。 当条件类型为以下值时必需：2、4、5。 |
要更好地理解如何将过滤器与各类表达式结合使用，请参阅检索关联和使用自定义表达式过滤器方法页面的示例。
每种条件类型支持的运算符和值如下：
| 条件 | 条件名称 | 支持的运算符 | 预期值 |
|---|---|---|---|
| 2 | Host group | =, <> | 主机分组ID。 |
| 4 | Old event tag value | =, <>, like, not like | string |
| 5 | New event tag value | =, <>, like, not like | string |