以下objects与service
API直接相关。
服务 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 - OK; 0 - 未分类; 1 - 信息; 2 - 警告; 3 - 一般; 4 - 高; 5 - 灾难。 |
status | integer | (只读) 服务是否处于OK或问题状态。 如果服务处于问题状态, status 等于:- 最严重问题的严重级别; - 处于问题状态的子服务的最高状态。 如果服务处于OK状态, status 等于 -1。 |
description | string | 服务的描述。 |
uuid | string | 通用唯一标识符。对于 update 操作,此字段为 只读。 |
created_at | integer | 服务创建时的Unix时间戳。 |
readonly | boolean | (只读) 对服务的访问权限。 可能的值: 0 - 读写; 1 - 只读。 |
请注意,对于某些方法(update、delete),必需/可选参数的组合是不同的。
状态规则 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 | 问题标签值。 |