> 对象

下列对象与联系 API 直接相关。

联系对象具有以下属性。

属性类	描述
correlationid	字符串 *（	读）* `联系`的 ID。
name （需要的）	字符串 `联\|`的名称。
description	字符串 `联\|`的描述。
status	整数 `\|系`是启用的还是禁用的。可能的值有： 0 - （默认）启用的； 1 - 禁用的。

联系操作对象定义了当一个联系被执行时，该操作的行为表现。它具有如下属性。

属性类	描述
type （需要的）	整数操	类型。可能的值： 0 - 关闭旧事件。 1 - 关闭新事件。

联系过滤对象定义了配置联系操作时，必须满足的一组条件。它具有如下属性。

属性类	描述
evaltype （需要的）	整数过	条件评价方法。可能的值： 0 - 与/或； 1 - 与； 2 - 或； 3 - 自定义表达式。
conditions （需要的）	数组用	过滤结果的一组过滤条件。
eval_formula	字符串 *（	读）* 生成的表达式将用于评估过滤条件。该表达式包含通过 “formulaid” 引用特定筛选条件的 ID。对于具有自定义表达式的筛选，`eval_formula` 的值等于 `formula` 的值。
formula	字符串用户	义的表达式，用于具有自定义表达式的过滤评估条件。该表达式必须包含通过 “formulaid” 引用特定筛选条件的 ID。表达式中使用的 ID 必须与过滤条件中定义的 ID 完全匹配：没有条件时可以不使用或省略。需要自定义表达式过滤。

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

属性类	描述
type （需要的）	整数条	类型。可能的值： 0 - 旧事件标签； 1 - 新事件标签； 2 - 新事件主机组； 3 - 事件标签对； 4 - 旧事件标签值； 5 - 新事件标签值。
tag	字符串事件	签（旧或新）。条件类型是：0, 1, 4, 5 时需要。
groupid	字符串主机	ID。条件类型是：2 时需要。
oldtag	字符串旧事	标签。条件类型是：3 时需要。
newtag	字符串新事	标签。条件类型是：3 时需要。
value	字符串事件	签（旧或新）值。条件类型是：4, 5 时需要。
formulaid	字符串任意	唯一 ID，用于引用一个自定义表达式中的条件。只能包含大写字母。当修改过滤条件时，该 ID 必须由用户定义，但以后请求它们时会重新生成。
operator	整数条	运算符。条件类型是：2, 4, 5 时需要。

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

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

Documentation