服务对象
以下对象与service API直接关联
服务
服务对象具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| serviceid | ID | 服务的 ID。 属性行为： - 只读 - 更新操作时必填 |
| algorithm | integer | 状态计算规则。仅在存在子服务时适用。 可能的值： 0 - 将状态设为 OK； 1 - 当所有子服务都有问题时，取最严重的状态； 2 - 取子服务中最严重的状态。 属性行为： - 创建操作时必填 |
| name | string | 服务名称。 属性行为： - 创建操作时必填 |
| sortorder | integer | 用于排序的服务位置。 可能的值：0-999。 属性行为： - 创建操作时必填 |
| weight | integer | 服务权重。 可能的值：0-1000000。 默认值：0。 |
| propagation_rule | integer | 状态传播规则。 可能的值： 0 - (默认) 按原样传播服务状态，不做任何更改； 1 - 按给定的 propagation_value 增加传播后的状态（增加 1 到 5 个严重性级别）；2 - 按给定的 propagation_value 降低传播后的状态（降低 1 到 5 个严重性级别）；3 - 忽略此服务 - 状态完全不会传播到父服务； 4 - 使用给定的 propagation_value 设置固定的服务状态。属性行为： - 设置了 propagation_value 时必填 |
| propagation_value | integer | 状态传播值。 当 propagation_rule 设置为 "0" 或 "3" 时，可能的值：0 - 未分类。 当 propagation_rule 设置为 "1" 或 "2" 时，可能的值：1 - 信息； 2 - 警告； 3 - 一般严重； 4 - 严重； 5 - 灾难。 当 propagation_rule 设置为 "4" 时，可能的值：-1 - OK； 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 一般严重； 4 - 严重； 5 - 灾难。 属性行为： - 设置了 propagation_rule 时必填 |
| status | integer | 服务是否处于 OK 或问题状态。 如果服务处于问题状态， status 等于以下之一：- 最严重问题的严重性； - 处于问题状态的子服务中的最高状态。 如果服务处于 OK 状态， status 等于：-1。属性行为： - 只读 |
| description | string | 服务描述。 |
| uuid | string | 通用唯一标识符，用于将导入的服务链接到已存在的服务。如果未提供，则自动生成。 |
| created_at | integer | 服务创建时的 Unix 时间戳。 |
| readonly | integer | 对服务的访问权限。 可能的值： 0 - 读写； 1 - 只读。 属性行为： - 只读 |
状态规则
状态规则对象具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| 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 - 灾难。 属性行为： - 必需 |
服务标签
服务标签对象具有以下属性。
服务告警
无法通过 Zabbix API 直接创建、更新或删除服务告警。
服务告警对象表示服务的状态变更。它具有以下属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| clock | timestamp | 服务状态变更发生的时间。 |
| value | integer | 服务的状态。 有关可能值的列表，请参见服务 status 属性。 |
故障标签
故障标签允许将服务与故障事件关联。故障标签对象具有以下属性。