> 对象

以下对象与serviceAPI直接相关。

Service 服务

服务对象具有以下属性。

属性类型说明
serviceid字符串(只读) 服务的ID。
algorithm
(required 必须)		整数型用于计算服务状态的算法。

可能的值：
0 - 不计算；
1 - 问题, 至少有一个子项有问题。
2 - 问题，所有子项都有问题。
name
(required 必须)		字符串服务的名称。
showsla
(required 必须)		整数型是否应计算SLA。

可能的值：
0 - 不计算；
1 - 计算。
sortorder
(required 必须)		整数型用于排序服务的位置。
goodsla浮点数最低可接受的SLA值，如果SLA降低，则该服务被认为处于有问题状态。

默认值：99.9。
status整数型(只读) 服务是否处于正常或故障状态。

如果服务处于故障状态， status 相当于以下情况之一：
- 如果告警级别设置值为2，那么链接触发器的告警级别为“警告”或更高（忽略告警级别0-“未分类”和1-“信息”）；
- 其中一个最高级别状态的子服务处于故障中。

如果服务是正常状态，那么status等于0。
字符串与服务相关联的触发器只能设置在没有子项的服务上。

默认：0

Service time 服务时间

当一个服务按照计划上线或下线时，服务时间对象可定义周期。服务时间对象具有以下属性。

属性类型说明
timeid字符串(只读) 服务时间的ID。
serviceid
(必须)		字符串服务的ID。

不可更新。
ts_from
(必须)		整数型服务时间生效的时间。

对于一次性停机时间，ts_from必须设置为Unix时间戳，对于其他类型的事件 —— 设置为一周中的特定时间，以秒为单位，例如，90000代表星期二，凌晨2:00。
ts_to
(必须)		整数型服务时间关闭的时间。

对于一次性开机时间，ts_to必须设置为Unix时间戳，对于其他类型的事件 —— 设置为一周中的特定时间，以秒为单位，例如，90000代表星期二，凌晨2:00。
type
(必须)		整数型服务时间类型

可能的值：
0 - 计划开机，每周重复；
1 - 计划停机，每周重复；
2 - 一次性停机。
note字符串有关服务时间的附加信息。

服务依赖

服务依赖对象表示服务之间的依赖关系，它具有以下属性。

属性类型说明
linkid字符串(只读) 服务依赖的ID。
servicedownid
(必须)		字符串被子服务依赖的服务ID，一个服务可以有多个子服务。
serviceupid
(必须)		字符串依赖于父服务的服务ID，一个服务可以有多个父服务，从而形成一张定向图表。
soft
(必须)		整数型服务之间的依赖关系类型。

可能的值：
0 - 硬依赖；
1 - 软依赖。

一个服务只能有一个强依赖的父服务。该属性对状态或SLA计算没有影响，仅用于创建核心服务树。 新增的父服务可以作为形成图形的软依赖添加。

如果服务有硬依赖子服务，则无法删除该服务。

服务告警

不能通过Zabbix API直接创建，更新或删除服务告警。

服务告警对象代表服务的状态变化，它具有以下属性。

属性类型说明
servicealarmid字符串服务告警的ID。
serviceid字符串服务的ID。
clock时间戳服务状态发生变化的时间。
value整数型服务的状态。

请参阅service status property以获取许可值列表。