这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.
2022 Zabbix中国峰会
2022 Zabbix中国峰会

> 关联对象

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

关联

关联对象具有以下属性。

属性 类型 说明
correlationid 字符 (只读)关联ID。
name
(必需)
字符 关联名称。
description 字符 关联描述。
status 整数 关联是否开启。

可用值:
0 - (默认)启用;
1 - 禁用。

注意,对于某些方法(更新、删除),必需/可选参数组合是不同的。

关联操作

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

属性 类型 说明
type
(必需)
integer 操作类型。

可用值:
0 - 关闭旧事件;
1 - 关闭新事件。

关联过滤

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

属性 类型 说明
evaltype
(必需)
integer 过滤条件的评估方法。

可用值:
0 - 与/或;
1 - 与;
2 - 或;
3 - 自定义表达式。
conditions
(必需)
array 用来过滤结果的一组过滤条件集。
eval_formula string (只读) 生成的表达式将用于评估过滤条件。该表达式包含通过 “formulaid” 引用特定筛选条件的 ID。对于具有自定义表达式的筛选,eval_formula 的值等于 formula 的值。
formula string 用于具有自定义表达式的过滤评估条件。该表达式必须包含通过 “formulaid” 引用特定筛选条件的 ID。表达式中使用的 ID 必须与过滤条件中定义的 ID 完全匹配:没有条件时可以不使用或省略。

自定义表达式过滤必需。

关联过滤条件

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

属性 类型 说明
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.getcorrelation.create 方法页面上的示例。

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

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