> 服务对象
以下对象与service API直接关联。
服务
服务对象有如下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| serviceid | string | (只读) 服务ID。 |
| algorithm (必需) |
integer | 状态计算规则。仅用于子服务存在时。 可能的值： 0 - 设置状态为正常; 1 - 最严重的，如果所有子服务存在问题； 2 - 子服务中最严重者。 |
| name (required) |
string | 服务名称。 |
| sortorder (必需) |
integer | 用于排序的服务位置。 可能的值： 0-999. |
| weight | integer | 服务权重。 可能的值： 0-1000000. Default: 0. |
| propagation_rule | integer | 状态传播规则。必须与propagation_value一起设置。可能的值： 0 - (默认) 原始传播服务状态； 1 - 按照给定的 propagation_value (按照1到5的严重性)增加传播状态;2 - 按照给定的 propagation_value (按照1到5的严重性)降低传播状态；3 - 忽略服务 - 状态根本不会传播给父服务； 4 - 按照给定 propagation_value设定固定服务状态。 |
| propagation_value | integer | 状态传播值。必须和propagation_rule一起设置。取值0和3的 propagation_rule可能的值：0.取值1和2的 propagation_rule可能的值：1-5.取值为4的 propagation_rule可能的值：-1 - 正常； 0 - 未分类； 1 - 信息； 2 - 警告; 3 - 一般； 4 - 严重； 5 - 灾难。 |
| status | integer | (只读) 服务是正常或问题状态。 如果服务处于问题状态， status为以下其中一种:- 最紧急问题的严重性； - 处于问题状子服务的最高状态。 如果服务处于正常状态， status等于-1。 |
| description | string | 服务描述。 |
| uuid | string | 通用唯一标识符。对更新操作，该字段是 只读。 |
| readonly | boolean | (只读) 服务的访问权限。 可能的值： 0 - 读写； 1 - 只读。 |
注意，对于某些方法（更新、删除），必需/可选参数组合是不同的。
状态规则
状态规则对象有如下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| type (必需) |
integer | 设置(New status)状态的条件。 可能的值： 0 - 如果至少（N）个子服务处于（Status）或更高的状态； 1 - 如果至少（N%）的子服务处于（Status）或更高的状态； 2 - 如果不到（N）个子服务处于（Status）或更低状态； 3 - 如果不到（N%）的子服务处于（Status）或更低状态； 4 - 如果处于（Status）或更高状态的子服务的重量至少达到（W）； 5 - 如果处于（Status）或更高状态的子服务的重量至少达到（N%）； 6 - 如果处于（Status）或更低状态的子服务的重量低于（W）； 7 - 如果处于（Status）或更低状态的子服务的重量低于（N%）。 其中： - N (W) 是 limit_value；- (Status) 是 limit_status；- (New 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 - 灾难。 |
服务标记
服务标记对象有如下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| tag (必须) |
string | 服务标签名称。 |
| value | string | 服务标签值。 |
服务告警
服务告警不能通过Zabbix API直接创建，更新或者删除 。
服务告警对象代表服务状态的变更。它有如下值：
问题标签
问题标签允许将服务和故障事件关联起来。问题标签对象有如下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| tag (必须) |
string | 问题标签名称。 |
| operator | integer | 条件运算符映射。 可能的值 0 - (默认) 等于； 2 - 类似。 |
| value | string | 问题标签值。 |