以下objects与correlation
API直接相关.
关联object具有以下属性.
属性 | 数据类型 | 描述 |
---|---|---|
correlationid | string | (只读) 关联的ID. |
name (required) |
string | 关联的名称. |
description | string | 关联的描述. |
status | integer | 关联是否启用或禁用. 可能的值为: 0 - (默认) 启用; 1 - 禁用. |
请注意,某些方法(update, delete)所需/可选参数组合有所不同.
关联操作object定义了执行关联时将执行的操作。它具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
type (required) |
integer | 操作类型。 可能的值: 0 - 关闭旧事件; 1 - 关闭新事件。 |
关联过滤器object定义了一组必须满足的条件才能执行配置的关联操作. 它具有以下属性.
属性 | 数据类型 | 描述 |
---|---|---|
evaltype (required) |
integer | 过滤条件评估方法. 可能的值: 0 - 与/或; 1 - 与; 2 - 或; 3 - 自定义表达式. |
conditions (required) |
array | 用于过滤结果的过滤条件集合. |
eval_formula | string | (只读) 生成的表达式,将用于评估过滤条件.该表达式包含通过formulaid 引用特定过滤条件的ID.对于自定义表达式的过滤器,eval_formula 的值等于formula 的值. |
formula | string | 用户定义的表达式,用于评估具有自定义表达式的过滤器的条件.该表达式必须包含通过formulaid 引用特定过滤条件的ID.表达式中使用的ID必须与过滤条件中定义的完全匹配:不能有任何条件未被使用或遗漏.自定义表达式过滤器必需. |
关联过滤器条件object定义了在运行关联操作前必须检查的特定条件。
属性 | 数据类型 | 描述 |
---|---|---|
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 | Host group | =, <> | 主机组 ID。 |
4 | Old event tag value | =, <>, like, not like | string |
5 | New event tag value | =, <>, like, not like | string |