以下objects与serviceAPI直接相关。

服务

服务 object 具有以下属性。

属性 数据类型 描述
serviceid string (只读) 服务ID。
algorithm
(required)
integer 状态计算规则。仅当存在子服务时适用。

可能取值:
0 - 将状态设置为OK;
1 - 所有子服务均存在问题则设为最严重状态;
2 - 取子服务中最严重的状态。
name
(required)
string 服务名称。
sortorder
(required)
integer 服务排序位置。

可能取值:0-999。
weight integer 服务权重。

可能取值:0-1000000。

默认值:0。
propagation_rule integer 状态传播规则。必须与propagation_value配合设置。

可能取值:
0 - (默认) 按原样传播服务状态;
1 - 按给定propagation_value提升传播状态(提升1至5级严重性);
2 - 按给定propagation_value降低传播状态(降低1至5级严重性);
3 - 忽略此服务,状态完全不传播至父服务;
4 - 使用给定propagation_value设置固定服务状态。
propagation_value integer 状态传播值。必须与propagation_rule配合设置。

propagation_rule取值为03时的可能值:0。

propagation_rule取值为12时的可能值:1-5。

propagation_rule取值为4时的可能值:
-1 - 正常;
0 - 未分类;
1 - 信息;
2 - 警告;
3 - 一般;
4 - 严重;
5 - 灾难。
status integer (只读) 服务处于正常或问题状态。

若服务处于问题状态,status等于:
- 最严重问题的严重级别;
- 问题状态子服务的最高状态。

若服务处于正常状态,status等于-1。
description string 服务描述。
uuid string 全局唯一标识符。更新操作时此字段为只读
created_at integer 服务创建时间的Unix时间戳。
readonly boolean (只读) 服务访问权限。

可能取值:
0 - 读写;
1 - 只读。

注意:部分方法(更新、删除)所需/可选参数组合可能不同。

状态规则

状态规则object具有以下属性。

属性 数据类型 描述
type
(required)
integer 设置(新状态)状态的条件。

可能的值:
0 - 如果至少有(N)个子服务具有(状态)状态或更高;
1 - 如果至少有(N%)的子服务具有(状态)状态或更高;
2 - 如果少于(N)个子服务具有(状态)状态或更低;
3 - 如果少于(N%)的子服务具有(状态)状态或更低;
4 - 如果具有(状态)状态或更高的子服务的权重至少为(W);
5 - 如果具有(状态)状态或更高的子服务的权重至少为(N%);
6 - 如果具有(状态)状态或更低的子服务的权重小于(W);
7 - 如果具有(状态)状态或更低的子服务的权重小于(N%)。

其中:
- N(W)是limit_value
- (状态)是limit_status
- (新状态)是new_status
limit_value
(required)
integer 限制值。

可能的值:
- 对于N和W:1-100000;
- 对于N%:1-100。
limit_status
(required)
integer 限制状态。

可能的值:
-1 - 正常;
0 - 未分类;
1 - 信息;
2 - 警告;
3 - 一般;
4 - 严重;
5 - 灾难。
new_status
(required)
integer 新状态值。

可能的值:
0 - 未分类;
1 - 信息;
2 - 警告;
3 - 一般;
4 - 严重;
5 - 灾难。

服务标签

服务标签object具有以下属性。

属性 数据类型 描述
tag
(required)
string 服务标签名称。
value string 服务标签值。

服务告警

服务告警无法直接通过Zabbix API创建、更新或删除。

服务告警 objects 代表服务状态变更,具有以下属性。

属性 数据类型 描述
clock timestamp 服务状态变更发生的时间。
value integer 服务状态。

具体可能值请参阅服务

问题标签

问题标签允许将服务与问题事件关联。问题标签object具有以下属性。

属性 数据类型 描述
tag
(required)
string 问题标签名称。
operator integer 映射条件运算符。

可选值:
0 - (默认) 等于;
2 - 类似。
value string 问题标签值。