服务 object

以下objects与serviceAPI直接相关.

服务

服务 object 具有以下属性。

属性 数据类型 描述
serviceid ID 服务的ID。

属性行为:
- 只读
- 进行 update 操作时必填
algorithm integer 状态计算规则。仅当存在子服务时适用。

可能的值:
0 - 将状态设置为OK;
1 - 如果所有子服务都有问题,则为最严重状态;
2 - 子服务中最严重的状态。

属性行为:
- 进行 create 操作时必填
name string 服务的名称。

属性行为:
- 进行 create 操作时必填
sortorder integer 用于排序的服务位置。

可能的值: 0-999。

属性行为:
- 进行 create 操作时必填
weight integer 服务权重。

可能的值: 0-1000000。

默认值: 0。
propagation_rule integer 状态传播规则。

可能的值:
0 - (默认) 按原样传播服务状态 - 不做任何更改;
1 - 按给定的 propagation_value 增加传播状态(增加1到5个严重级别);
2 - 按给定的 propagation_value 减少传播状态(减少1到5个严重级别);
3 - 忽略此服务 - 状态完全不传播到父服务;
4 - 使用给定的 propagation_value 设置固定的服务状态。

属性行为:
- 如果设置了 propagation_value必填
propagation_value integer 状态传播值。

如果 propagation_rule 设置为 "0" 或 "3" 时的可能值:
0 - 未分类。

如果 propagation_rule 设置为 "1" 或 "2" 时的可能值:
1 - 信息;
2 - 警告;
3 - 一般;
4 - 高;
5 - 灾难。

如果 propagation_rule 设置为 "4" 时的可能值:
-1 - OK;
0 - 未分类;
1 - 信息;
2 - 警告;
3 - 一般;
4 - 高;
5 - 灾难。

属性行为:
- 如果设置了 propagation_rule必填
status integer 服务是否处于OK或问题状态。

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

如果服务处于OK状态,status 等于: -1。

属性行为:
- 只读
description string 服务的描述。
uuid string 通用唯一标识符,用于将导入的服务链接到已存在的服务。如果未提供,则自动生成。
created_at integer 服务创建时的Unix时间戳。
readonly boolean 对服务的访问权限。

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

属性行为:
- 只读

状态规则

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

属性 数据类型 描述
type 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 integer 限制值。

可能的值:
- 对于N和W:1-100000;
- 对于N%:1-100。

属性行为:
- 必填
limit_status integer 限制状态。

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

属性行为:
- 必填
new_status integer 新状态值。

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

属性行为:
- 必填

服务标签

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

属性 数据类型 描述
tag string 服务标签名称.

属性行为:
- 必填
value string 服务标签值.

服务告警

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

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

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

可参考service status property获取可能值的列表。

问题标签

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

属性 数据类型 描述
tag string 问题标签名称。

属性行为:
- 必填
operator integer 映射条件运算符。

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