关联 object

以下objects与correlation API直接相关.

关联

关联object具有以下属性.

属性 数据类型 描述
correlationid string (只读) 关联的ID.
name
(required)
string 关联的名称.
description string 关联的描述.
status integer 关联是否启用或禁用.

可能的值为:
0 - (默认) 启用;
1 - 禁用.

请注意,某些方法(update, delete)所需/可选参数组合有所不同.

关联操作

关联操作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必须与过滤条件中定义的完全匹配:不能有任何条件未被使用或遗漏.

自定义表达式过滤器必需.

关联过滤条件

关联过滤器条件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。

要更好地理解如何将过滤器与各种表达式类型结合使用,请参阅 correlation.getcorrelation.create方法页面的示例。

以下列出了每种条件类型支持的运算符和值。

条件 条件名称 支持的运算符 期望值
2 Host group =, <> 主机组 ID。
4 Old event tag value =, <>, like, not like string
5 New event tag value =, <>, like, not like string