服务 object
以下objects与serviceAPI直接相关.
服务
服务 object 具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| serviceid | ID | 服务的ID。 属性行为: - 只读 - 进行 update 操作时必填 |
| algorithm | integer | 状态计算规则。仅当存在子服务时适用。 可能的值: 0 - 将状态设置为OK; 1 - 如果所有子服务都有问题，则为最严重状态; 2 - 子服务中最严重的状态。 属性行为: - 进行 create 操作时必填 |
| name | string | 服务的名称。 属性行为: - 进行 create 操作时必填 |
| sortorder | integer | 用于排序的服务位置。 可能的值: 0-999。 属性行为: - 进行 create 操作时必填 |
| 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 | boolean | 对服务的访问权限。 可能的值: 0 - 读写; 1 - 只读。 属性行为: - 只读 |
状态规则
状态规则 object 具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| 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 - 灾难。 属性行为: - 必填 |
服务标签
服务标签object具有以下属性.
服务告警
服务告警无法直接通过Zabbix API创建、更新或删除。
服务告警objects表示服务状态变更，具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| clock | timestamp | 服务状态变更发生的时间。 |
| value | integer | 服务状态。 可参考service status property获取可能值的列表。 |
问题标签
问题标签允许将服务与问题事件关联。问题标签 object 具有以下属性。