这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

> 对象

以下对象与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以获取许可值列表。