> 服务 object

以下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_rule03 时的可能值:0。

propagation_rule12 时的可能值:1-5。

propagation_rule4 时的可能值:
-1 - OK;
0 - 未分类;
1 - 信息;
2 - 警告;
3 - 一般;
4 - 高;
5 - 灾难。
status integer (只读) 服务是否处于OK或问题状态。

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

如果服务处于OK状态,status 等于 -1。
description string 服务的描述。
uuid string 通用唯一标识符。对于 update 操作,此字段为 只读
created_at integer 服务创建时的Unix时间戳。
readonly boolean (只读) 对服务的访问权限。

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

请注意,对于某些方法(update、delete),必需/可选参数的组合是不同的。

状态规则

状态规则 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 问题标签值。