以下对象与关联
API直接相关。
关联对象具有以下属性。
属性 | 类型 | 描述 |
---|---|---|
correlationid | ID | 关联的ID。 属性行为: - 只读 - 更新操作的必需项 |
name | string | 关联的名称。 属性行为: - 创建操作的必需项 |
description | string | 关联的描述。 |
status | integer | 关联是否启用或禁用。 可能的值: 0 - (默认) 启用; 1 - 禁用。 |
关联操作对象定义执行关联时将执行的操作。它具有如下属性。
属性 | 类型 | 说明 |
---|---|---|
type (必需) |
integer | 操作类型。 可用值: 0 - 关闭旧事件; 1 - 关闭新事件。 |
关联过滤器对象定义了一组必须满足的条件,以便执行配置的相关性操作。它具有以下属性:
属性 | 类型 | 描述 |
---|---|---|
conditions | array | 用于过滤结果的过滤器条件集合。条件将按照它们在公式中的顺序进行排序。 属性行为: - 必需 |
evaltype | integer | 过滤器条件评估方法。 可能的值: 0 - 与/或; 1 - 与; 2 - 或; 3 - 自定义表达式。 属性行为: - 必需 |
eval_formula | string | 用于评估过滤器条件的生成表达式。该表达式包含引用特定过滤器条件的 formulaid 的 ID。当过滤器使用自定义表达式时,eval_formula 的值等于过滤器的 formula 值。属性行为: - 只读 |
formula | string | 用户定义的表达式,用于评估具有自定义表达式的过滤器的条件。表达式必须包含引用特定过滤器条件的 formulaid 的 ID。在表达式中使用的 ID 必须与过滤器条件中定义的 ID 完全匹配:不能有未使用或遗漏的条件。属性行为: - 如果 evaltype 设置为“自定义表达式”,则为必需 |
关联过滤条件对象定义了在运行关联操作之前必须检查的特定条件。
属性 | 类型 | 说明 |
---|---|---|
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.get 和correlation.create 方法页面上的示例。
以下运算符和值都支持每种条件类型。
条件 | 条件名称 | 支持运算符 | 期望的值 |
---|---|---|---|
2 | 主机组 | =, <> | 主机组 ID。 |
4 | 旧事件标签值 | =, <>, like, not like | string |
5 | 新事件标签值 | =, <>, like, not like | string |