关联对象
以下对象与关联 API直接相关。
关联
关联对象具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| correlationid | ID | 关联的 ID。 属性行为： - 只读 - 更新操作时 必填 |
| name | string | 关联的名称。 属性行为： - 创建操作时 必填 |
| description | string | 关联的描述。 |
| status | integer | 关联是启用还是禁用。 可能的值： 0 - (默认) 启用； 1 - 禁用。 |
关联操作
关联操作对象定义了在执行关联时将执行的操作。它具有以下属性。
关联筛选器
关联筛选器对象定义了一组必须满足的条件，以执行已配置的关联操作。 它具有以下属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| conditions | array | 用于筛选结果的筛选条件集合。条件将按照其在公式中的排列顺序进行排序。 属性行为: - 必填 |
| evaltype | integer | 筛选条件的求值方法。 可能的值： 0 - And/Or； 1 - And； 2 - Or； 3 - 自定义表达式。 属性行为: - 必填 |
| eval_formula | string | 用于对筛选条件进行求值的生成表达式。该表达式包含通过其 formulaid 引用特定筛选条件的 ID。对于使用自定义表达式的筛选器，eval_formula 的值等于 formula 的值。属性行为: - 只读 |
| formula | string | 用户定义的表达式，用于对使用自定义表达式的筛选器条件进行求值。该表达式必须包含通过其 formulaid 引用特定筛选条件的 ID。表达式中使用的 ID 必须与筛选条件中定义的 ID 完全匹配：不能有任何条件未被使用或被省略。属性行为: - 如果 evaltype 设置为“自定义表达式”，则为 必填 |
关联筛选条件
关联筛选条件对象定义了一个特定条件， 在运行关联操作之前必须先检查该条件。
| 属性 | 类型 | 描述 |
|---|---|---|
| type | integer | 条件类型。 可能的值： 0 - 旧事件标签； 1 - 新事件标签； 2 - 新事件主机组； 3 - 事件标签对； 4 - 旧事件标签值； 5 - 新事件标签值。 属性行为： - 必需 |
| tag | string | 事件标签（旧或新）。 属性行为： - 如果 type 设置为“旧事件标签”、“新事件标签”、“旧事件标签值”或“新事件标签值”，则为 必需 |
| groupid | ID | 主机组的 ID。 属性行为： - 如果 type 设置为“新事件主机组”，则为 必需 |
| oldtag | string | 旧事件标签。 属性行为： - 如果 type 设置为“事件标签对”，则为 必需 |
| newtag | string | 旧事件标签。 属性行为： - 如果 type 设置为“事件标签对”，则为 必需 |
| value | string | 事件标签（旧或新）的值。 属性行为： - 如果 type 设置为“旧事件标签值”或“新事件标签值”，则为 必需 |
| formulaid | string | 用于在自定义表达式中引用该条件的任意唯一 ID。只能包含大写字母。修改筛选条件时，该 ID 必须由用户定义；但在之后请求这些条件时，将重新生成该 ID。 |
| operator | integer | 条件运算符。 属性行为： - 如果 type 设置为“新事件主机组”、“旧事件标签值”或“新事件标签值”，则为 必需 |
为了更好地理解如何将筛选器与各种类型的表达式配合使用，请参见 correlation.get 和 correlation.create 方法页面中的 示例。
以下是每种条件类型支持的运算符和值。
| 条件 | 条件名称 | 支持的运算符 | 预期值 |
|---|---|---|---|
| 2 | 主机组 | =, <> | 主机组 ID。 |
| 4 | 旧事件标签值 | =, <>, like, not like | string |
| 5 | 新事件标签值 | =, <>, like, not like | string |