[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({f1f8a413-e205e572})
# 关联对象

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

[comment]: # ({/f1f8a413-e205e572})

[comment]: # ({ba90c834-935ba6ef})
### 关联

关联对象具有以下属性。

|属性|[类型](/manual/api/reference_commentary#data_types)|描述|
|--|--|------|
|correlationid|ID|关联的ID。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*<br>- 更新操作的*必需*项|
|name|string|关联的名称。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- 创建操作的*必需*项|
|description|string|关联的描述。|
|status|integer|关联是否启用或禁用。<br><br>可能的值：<br>0 - *（默认）* 启用；<br>1 - 禁用。|

[comment]: # ({/ba90c834-935ba6ef})

[comment]: # ({cc090c12-d12c2169})
### 关联操作

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

|属性|[类型](/manual/api/reference_commentary#数据类型)|说明|
|--------|---------------------------------------------------|-----------|
|**type**<br>（必需）|integer|操作类型。<br><br>可用值：<br>0 - 关闭旧事件；<br>1 - 关闭新事件。|

[comment]: # ({/cc090c12-d12c2169})

[comment]: # ({670ca078-d0662dba})
### 关联过滤器

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

|属性|[类型](/manual/api/reference_commentary#data_types)|描述|
|--|--|------|
|conditions|array|用于过滤结果的[过滤器条件](#correlation-filter-condition)集合。条件将按照它们在公式中的顺序进行排序。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *必需*|
|evaltype|integer|过滤器条件评估方法。<br><br>可能的值：<br>0 - 与/或；<br>1 - 与；<br>2 - 或；<br>3 - 自定义表达式。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *必需*|
|eval_formula|string|用于评估过滤器条件的生成表达式。该表达式包含引用特定过滤器条件的 `formulaid` 的 ID。当过滤器使用自定义表达式时，`eval_formula` 的值等于过滤器的 `formula` 值。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- *只读*|
|formula|string|用户定义的表达式，用于评估具有自定义表达式的过滤器的条件。表达式必须包含引用特定过滤器条件的 `formulaid` 的 ID。在表达式中使用的 ID 必须与过滤器条件中定义的 ID 完全匹配：不能有未使用或遗漏的条件。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior)：<br>- 如果 `evaltype` 设置为“自定义表达式”，则为*必需*|

[comment]: # ({/670ca078-d0662dba})

[comment]: # ({32db8e3e-72ee5420})
#### 关联过滤条件

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

|属性|[类型](/manual/api/reference_commentary#数据类型)|说明|
|--------|---------------------------------------------------|-----------|
|**type**<br>（required）|integer|条件类型。<br><br>可用值：<br>0 - 旧事件标签；<br>1 - 新事件标签；<br>2 - 新事件主机组；<br>3 - 事件标签对；<br>4 - 旧事件标签值；<br>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|条件运算符。<br><br>条件类型是：2, 4, 5 时需要。|

::: notetip
为了更好地了解如何使用具有各种类型的过滤表达式，请参阅 [correlation.get](get#获取关联) 和[correlation.create](create#使用一个自定义表达式过滤) 方法页面上的示例。
:::

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

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

[comment]: # ({/32db8e3e-72ee5420})