以下objects与serviceAPI直接相关。
服务
服务 object 具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| serviceid | string | (只读) 服务ID。 |
| algorithm (required) |
integer | 状态计算规则。仅当存在子服务时适用。 可能取值： 0 - 将状态设置为OK； 1 - 所有子服务均存在问题则设为最严重状态； 2 - 取子服务中最严重的状态。 |
| name (required) |
string | 服务名称。 |
| sortorder (required) |
integer | 服务排序位置。 可能取值：0-999。 |
| weight | integer | 服务权重。 可能取值：0-1000000。 默认值：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配合设置。propagation_rule取值为0和3时的可能值：0。propagation_rule取值为1和2时的可能值：1-5。propagation_rule取值为4时的可能值：-1 - 正常； 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 一般； 4 - 严重； 5 - 灾难。 |
| status | integer | (只读) 服务处于正常或问题状态。 若服务处于问题状态， status等于：- 最严重问题的严重级别； - 问题状态子服务的最高状态。 若服务处于正常状态， status等于-1。 |
| description | string | 服务描述。 |
| uuid | string | 全局唯一标识符。更新操作时此字段为只读。 |
| created_at | integer | 服务创建时间的Unix时间戳。 |
| readonly | boolean | (只读) 服务访问权限。 可能取值： 0 - 读写； 1 - 只读。 |
注意：部分方法（更新、删除）所需/可选参数组合可能不同。
状态规则
状态规则object具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| type (required) |
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 (required) |
integer | 限制值。 可能的值： - 对于N和W：1-100000； - 对于N%：1-100。 |
| limit_status (required) |
integer | 限制状态。 可能的值： -1 - 正常； 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 一般； 4 - 严重； 5 - 灾难。 |
| new_status (required) |
integer | 新状态值。 可能的值： 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 一般； 4 - 严重； 5 - 灾难。 |
服务标签
服务标签object具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| tag (required) |
string | 服务标签名称。 |
| value | string | 服务标签值。 |
服务告警
服务告警无法直接通过Zabbix API创建、更新或删除。
服务告警 objects 代表服务状态变更，具有以下属性。
问题标签
问题标签允许将服务与问题事件关联。问题标签object具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| tag (required) |
string | 问题标签名称。 |
| operator | integer | 映射条件运算符。 可选值： 0 - (默认) 等于； 2 - 类似。 |
| value | string | 问题标签值。 |