服务对象

以下对象与service API直接关联

Service

service 对象具有以下属性。

Property Type Description
serviceid ID service 的 ID。

Property behavior:
- read-only
- required for update operations
algorithm integer 状态计算规则。仅在存在子 service 时适用。

Possible values:
0 - 将状态设置为 OK；
1 - 如果所有子项都有问题，则取最严重的状态；
2 - 取子 service 中最严重的状态。

Property behavior:
- required for create operations
name string service 的名称。

Property behavior:
- required for create operations
sortorder integer 用于排序的 service 位置。

Possible values: 0-999.

Property behavior:
- required for create operations
weight integer service 权重。

Possible values: 0-1000000.

Default: 0.
propagation_rule integer 状态传播规则。

Possible values:
0 - (default) 按原样传播 service 状态 - 不做任何更改；
1 - 将传播后的状态按给定的 propagation_value 提高（提高 1 到 5 个严重级别）；
2 - 将传播后的状态按给定的 propagation_value 降低（降低 1 到 5 个严重级别）；
3 - 忽略此 service - 状态根本不会传播到父 service；
4 - 使用给定的 propagation_value 设置固定的 service 状态。

Property behavior:
- required if propagation_value is set
propagation_value integer 状态传播值。

Possible values if propagation_rule is set to "0" or "3":
0 - 未分类。

Possible values if propagation_rule is set to "1" or "2":
1 - 信息；
2 - 警告；
3 - 一般；
4 - 严重；
5 - 灾难。

Possible values if propagation_rule is set to "4":
-1 - OK；
0 - 未分类；
1 - 信息；
2 - 警告；
3 - 一般；
4 - 严重；
5 - 灾难。

Property behavior:
- required if propagation_rule is set
status integer service 处于 OK 还是问题状态。

如果 service 处于问题状态，status 等于最严重问题的严重级别，或处于问题状态的子 service 的最高状态。

如果 service 处于 OK 状态，status 等于 -1。

Property behavior:
- read-only
description string service 的描述。
uuid string 通用唯一标识符，用于将导入的 service 链接到已存在的 service。若未提供，则自动生成。
created_at integer service 创建时的 Unix 时间戳。
readonly integer 对 service 的访问权限。

Possible values:
0 - 可读写；
1 - 只读。

Property behavior:
- read-only

状态规则

状态规则对象具有以下属性。

属性 类型 描述
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 - 灾难。

属性行为：
- 必需

服务标签

服务标签对象具有以下属性。

属性 Type 说明
tag string 服务标签名称。

属性行为：
- 必填
value string 服务标签值。

服务告警

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

服务告警对象表示服务状态的变更。 它具有以下属性。

Property Type Description
clock timestamp 服务状态变更发生的时间。
value integer 服务的状态。

有关可能值的列表，请参阅 service status property。

问题标签

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

Property Type Description
tag string 问题标签名称。

Property behavior:
- required
operator integer 映射条件 operator。

Possible values:
0 - (default) Equals;
2 - Contains.
value string 问题标签值。