服务对象

以下对象与service API直接关联

服务

服务对象具有以下属性。 属性 类型 描述
serviceid ID 服务ID

Property behavior:
- 只读
- 更新操作所需
algorithm integer 状态计算规则。仅适用于存在子服务的情况。

许可值
0 - 设置状态为ok
1 - 所有关键的之服务有问题
2 - 最关键的自服务

Property behavior:
- 创建操作所需
name string 服务名称

Property behavior:
- 创建操作所需
sortorder integer 服务排名

范围: 0-999.

Property behavior:
- 创建操作所需
weight integer 服务权重

范围: 0-1000000.

默认: 0.
propagation_rule integer 状态影响规则

许可值
0 - (默认) 按默认影响服务状态-没有任何更改；
1 - 将影响状态增加给定的propagation_value（1到5是严重性）；;
2 - 将影响状态降低给定的影响值（1到5是严重性）；;
3 - 忽略此服务-状态不会影响到父服务；
4 - 使用给定的propagation_value设置固定服务状态

Property behavior:
- 设置影响值需要
propagation_value integer 状态影响值

如果propagation_rule设置为“0”或“3”，则可能的值为：
0 - 未分类。

如果propagation_rule设置为“1”或“2”，则可能的值为：
1 - 消息
2 - 警告
3 - 一般
4 - 严重
5 - 灾难

如果propagation_rule设置为“4”，则可能的值为：
-1 - 恢复
0 -未分类
1 - 消息
2 - 警告
3 - 一半
4 - 严重
5 - 灾难

Property behavior:
- 置影响规则使用
status integer 服务是否处于正常或有问题的状态。

如果服务处于问题状态，则状态等于：
- 最关键问题的严重性；
- 处于问题状态的子服务的最高状态。

如果服务处于正常状态，则状态值等于：-1。

Property behavior:
- 只读
description string 服务描述
uuid string 通用唯一标识符，用于将导入的服务链接到现有服务。自动生成，如果未给定。
created_at integer 创建服务时间戳。
readonly boolean 访问服务

Possible values:
0 - 读-写
1 - 只读

Property behavior:
- 只读

状态规则

状态规则对象具有以下属性。 属性 类型 描述
type integer 设置（新状态）状态的条件。

许可值
0 - 如果至少（N）个子服务具有（Status）状态或以上；
1 - 如果至少（N%）的子服务具有（状态）状态或以上；
2 - 如果少于（N）个子服务有（状态）状态或以下；
3 - 如果少于（N%）的子服务具有（状态）状态或低于（状态）；
4 - 如果具有（状态）或子服务的权重最低（W）
5 - 如果具有（状态）或子童服务的权重至少为（N%）；
6 - 如果（状态）或子服务的权重小于（W）
7 - 如果（状态）状态或以下的子服务的权重小于（N%）。

Where:
- -N（W）是极限值；
- (Status) 最小值
- (New status) 最新状态.

Property behavior:
- required
limit_value integer 最小值

范围
- for N and W: 1-100000;
- for N%: 1-100.

Property behavior:
- required
limit_status integer 状态值

许可值
-1 - 正常
0 - 未分类
1 - 消息
2 - 警告
3 - 平均
4 - 严重
5 - 灾难

Property behavior:
- required
new_status integer 新的状态值

许可值:
0 - 未分类
1 - 消息
2 - 告警
3 - 平均
4 - 严重
5 - 灾难.

Property behavior:
- required

服务标签

这个服务标签具有以下属性 属性 类型 描述
tag string 服务标签名称

Property behavior:
- required
value string 服务标签对应的值

服务告警

::: 请注意 无法通过Zabbix API直接创建、更新或删除服务警报。 ::: 服务报警对象表示服务的状态变化。它具有以下属性。

属性 类型 描述
clock timestamp 这个服务状态发生改变的时间
value integer 服务状态

有关可能值的列表，请参阅service'status`属性。

问题标记

问题标记允许将服务与问题事件链接起来。问题标记对象具有以下属性。 属性 类型 描述
tag string 问题标签名称

Property behavior:
- required
operator integer 对应运算符

Possible values:
0 - (默认) 等于
2 - 相似
value string 问题标签对应值