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