[comment]: # translation:outdated
[comment]: # ({b1a89f1b-b1a89f1b})
# > 服务 object
以下objects与`service`API直接相关。
[comment]: # ({/b1a89f1b-b1a89f1b})
[comment]: # ({132baa34-4a7e98f0})
### 服务
服务 object 具有以下属性。
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|-----------------------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 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），必需/可选参数的组合是不同的。
[comment]: # ({/132baa34-4a7e98f0})
[comment]: # ({6bfdbc42-6bfdbc42})
### 状态规则
状态规则 object 具有以下属性。
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|---------------------------------|-----------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **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 - 灾难。 |
[comment]: # ({/6bfdbc42-6bfdbc42})
[comment]: # ({9903142f-9903142f})
### 服务标签
服务标签object具有以下属性.
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|-----------------------|-----------------------------------------------------|--------------------|
| **tag**
(required) | string | 服务标签名称. |
| value | string | 服务标签值. |
[comment]: # ({/9903142f-9903142f})
[comment]: # ({fe2d8044-fe2d8044})
### 服务告警
::: noteclassic
服务告警无法直接通过Zabbix API创建、更新或删除。
:::
服务告警objects表示服务状态变更，具有以下属性。
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|----------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|
| clock | timestamp | 服务状态变更发生的时间。 |
| value | integer | 服务状态。
可参考[服务](object#服务)获取可能值的列表。 |
[comment]: # ({/fe2d8044-fe2d8044})
[comment]: # ({1c3ecb40-1c3ecb40})
### 问题标签
问题标签允许将服务与问题事件关联。问题标签
object 具有以下属性。
| 属性 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|-----------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------|
| **tag**
(required) | string | 问题标签名称。 |
| operator | integer | 映射条件运算符。
可能取值:
0 - *(默认)* 等于;
2 - 类似。 |
| value | string | 问题标签值。 |
[comment]: # ({/1c3ecb40-1c3ecb40})