[comment]: # aside: 1
[comment]: # ({9e9adb41-b1a89f1b})
# 服务对象
以下对象与`service` API直接关联
[comment]: # ({/9e9adb41-b1a89f1b})
[comment]: # ({64f35abb-5d7a3d70})
### Service
service 对象具有以下属性。
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|serviceid|ID|service 的 ID。
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*
- *required* for update operations|
|algorithm|integer|状态计算规则。仅在存在子 service 时适用。
Possible values:
0 - 将状态设置为 OK；
1 - 如果所有子项都有问题，则取最严重的状态；
2 - 取子 service 中最严重的状态。
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations|
|name|string|service 的名称。
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations|
|sortorder|integer|用于排序的 service 位置。
Possible values: 0-999.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations|
|weight|integer|service 权重。
Possible values: 0-1000000.
Default: 0.|
|propagation\_rule|integer|状态传播规则。
Possible values:
0 - *(default)* 按原样传播 service 状态 - 不做任何更改；
1 - 将传播后的状态按给定的 `propagation_value` 提高（提高 1 到 5 个严重级别）；
2 - 将传播后的状态按给定的 `propagation_value` 降低（降低 1 到 5 个严重级别）；
3 - 忽略此 service - 状态根本不会传播到父 service；
4 - 使用给定的 `propagation_value` 设置固定的 service 状态。
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* if `propagation_value` is set|
|propagation\_value|integer|状态传播值。
Possible values if `propagation_rule` is set to "0" or "3":
0 - 未分类。
Possible values if `propagation_rule` is set to "1" or "2":
1 - 信息；
2 - 警告；
3 - 一般；
4 - 严重；
5 - 灾难。
Possible values if `propagation_rule` is set to "4":
-1 - OK；
0 - 未分类；
1 - 信息；
2 - 警告；
3 - 一般；
4 - 严重；
5 - 灾难。
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* if `propagation_rule` is set|
|status|integer|service 处于 OK 还是问题状态。
如果 service 处于问题状态，`status` 等于最严重问题的严重级别，或处于问题状态的子 service 的最高状态。
如果 service 处于 OK 状态，`status` 等于 -1。
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|description|string|service 的描述。|
|uuid|string|通用唯一标识符，用于将导入的 service 链接到已存在的 service。若未提供，则自动生成。|
|created_at|integer|service 创建时的 Unix 时间戳。|
|readonly|integer|对 service 的访问权限。
Possible values:
0 - 可读写；
1 - 只读。
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
[comment]: # ({/64f35abb-5d7a3d70})
[comment]: # ({dd16f497-c2041847})
### 状态规则
状态规则对象具有以下属性。
|属性|[类型](/manual/api/reference_commentary#data-types)|描述|
|--|--|------|
|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`。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *必需*|
|limit\_value|integer|限制值。
可能的值：
- 对于 N 和 W：1-100000；
- 对于 N%：1-100。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *必需*|
|limit\_status|integer|限制状态。
可能的值：
-1 - 正常；
0 - 未分类；
1 - 信息；
2 - 警告；
3 - 一般严重；
4 - 严重；
5 - 灾难。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *必需*|
|new\_status|integer|新状态值。
可能的值：
0 - 未分类；
1 - 信息；
2 - 警告；
3 - 一般严重；
4 - 严重；
5 - 灾难。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *必需*|
[comment]: # ({/dd16f497-c2041847})
[comment]: # ({72128b59-c301cfb2})
### 服务标签
服务标签对象具有以下属性。
|属性|[Type](/manual/api/reference_commentary#data-types)|说明|
|--|--|------|
|tag|string|服务标签名称。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *必填*|
|value|string|服务标签值。|
[comment]: # ({/72128b59-c301cfb2})
[comment]: # ({92be70e8-e6daa7b4})
### 服务告警
::: noteclassic
无法通过 Zabbix API 直接创建、更新或删除服务告警。
:::
服务告警对象表示服务状态的变更。
它具有以下属性。
|Property |[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|clock|timestamp|服务状态变更发生的时间。|
|value|integer|服务的状态。
有关可能值的列表，请参阅 [service `status` property](object#service)。|
[comment]: # ({/92be70e8-e6daa7b4})
[comment]: # ({88aae5fd-6b88d3dc})
### 问题标签
问题标签允许将服务与问题事件关联起来。
问题标签对象具有以下属性。
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|问题标签名称。
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*|
|operator|integer|映射条件 [operator](/manual/it_services/service_tree#service-configuration)。
Possible values:
0 - *(default)* Equals;
2 - Contains.|
|value|string|问题标签值。|
[comment]: # ({/88aae5fd-6b88d3dc})