关联对象

以下对象与关联 API直接相关。

关联

关联对象具有以下属性。

属性类型描述
correlationidID关联的ID。

属性行为：
- 只读
- 更新操作的必需项
namestring关联的名称。

属性行为：
- 创建操作的必需项
descriptionstring关联的描述。
statusinteger关联是否启用或禁用。

可能的值：
0 - （默认） 启用；
1 - 禁用。

关联操作

关联操作对象定义执行关联时将执行的操作。它具有如下属性。

属性类型说明
type
（必需）		integer操作类型。

可用值：
0 - 关闭旧事件；
1 - 关闭新事件。

关联过滤器

关联过滤器对象定义了一组必须满足的条件，以便执行配置的相关性操作。它具有以下属性：

属性类型描述
conditionsarray用于过滤结果的过滤器条件集合。条件将按照它们在公式中的顺序进行排序。

属性行为：
- 必需
evaltypeinteger过滤器条件评估方法。

可能的值：
0 - 与/或；
1 - 与；
2 - 或；
3 - 自定义表达式。

属性行为：
- 必需
eval_formulastring用于评估过滤器条件的生成表达式。该表达式包含引用特定过滤器条件的 formulaid 的 ID。当过滤器使用自定义表达式时，eval_formula 的值等于过滤器的 formula 值。

属性行为：
- 只读
formulastring用户定义的表达式，用于评估具有自定义表达式的过滤器的条件。表达式必须包含引用特定过滤器条件的 formulaid 的 ID。在表达式中使用的 ID 必须与过滤器条件中定义的 ID 完全匹配：不能有未使用或遗漏的条件。

属性行为：
- 如果 evaltype 设置为“自定义表达式”，则为必需

关联过滤条件

关联过滤条件对象定义了在运行关联操作之前必须检查的特定条件。

属性类型说明
type
（required）		integer条件类型。

可用值：
0 - 旧事件标签；
1 - 新事件标签；
2 - 新事件主机组；
3 - 事件标签对；
4 - 旧事件标签值；
5 - 新事件标签值。
tagstring标签（旧或新）。条件类型是：0, 1, 4, 5 时需要。
groupidstring主机组ID。条件类型是：2 时需要。
oldtagstring旧事件标签。条件类型是：3 时需要。
newtagstring新事件标签。条件类型是：3 时需要。
valuestring事件标签(旧或新)值。条件类型是：4, 5 时需要。
formulaidstring任意唯一 ID，用于引用一个自定义表达式中的条件。只能包含大写字母。当修改过滤条件时，该 ID 必须由用户定义，但以后请求它们时会重新生成。
operatorinteger条件运算符。

条件类型是：2, 4, 5 时需要。

为了更好地了解如何使用具有各种类型的过滤表达式，请参阅 correlation.get 和correlation.create 方法页面上的示例。

以下运算符和值都支持每种条件类型。

条件条件名称支持运算符期望的值
2主机组=, <>主机组 ID。
4旧事件标签值=, <>, like, not likestring
5新事件标签值=, <>, like, not likestring