[comment]: # aside: 1

[comment]: # ({9e9adb41-b1a89f1b})
# Объект service

Следующие объекты напрямую связаны с API `service`.

[comment]: # ({/9e9adb41-b1a89f1b})

[comment]: # ({92b0166a-5d7a3d70})
### Сервис

Объект service имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|serviceid|ID|ID сервиса.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*<br>- *обязательно* для операций обновления|
|algorithm|integer|Правило расчета статуса. Применимо только если существуют дочерние сервисы.<br><br>Возможные значения:<br>0 - установить статус в OK;<br>1 - наиболее критичный, если у всех дочерних сервисов есть проблемы;<br>2 - наиболее критичный из дочерних сервисов.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|name|string|Имя сервиса.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|sortorder|integer|Позиция сервиса, используемая для сортировки.<br><br>Возможные значения: 0-999.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|weight|integer|Вес сервиса.<br><br>Возможные значения: 0-1000000.<br><br>По умолчанию: 0.|
|propagation\_rule|integer|Правило распространения статуса.<br><br>Возможные значения:<br>0 - *(по умолчанию)* распространять статус сервиса как есть - без каких-либо изменений;<br>1 - увеличить распространяемый статус на заданное `propagation_value` (на 1-5 уровней серьезности);<br>2 - уменьшить распространяемый статус на заданное `propagation_value` (на 1-5 уровней серьезности);<br>3 - игнорировать этот сервис - статус вообще не распространяется на родительский сервис;<br>4 - установить фиксированный статус сервиса с использованием заданного `propagation_value`.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно*, если задан `propagation_value`|
|propagation\_value|integer|Значение распространения статуса.<br><br>Возможные значения, если `propagation_rule` установлено в "0" или "3":<br>0 - Не классифицировано.<br><br>Возможные значения, если `propagation_rule` установлено в "1" или "2":<br>1 - Информация;<br>2 - Предупреждение;<br>3 - Средняя;<br>4 - Высокая;<br>5 - Катастрофа.<br><br>Возможные значения, если `propagation_rule` установлено в "4":<br>-1 - OK;<br>0 - Не классифицировано;<br>1 - Информация;<br>2 - Предупреждение;<br>3 - Средняя;<br>4 - Высокая;<br>5 - Катастрофа.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно*, если задано `propagation_rule`|
|status|integer|Находится ли сервис в состоянии OK или в состоянии проблемы.<br><br>Если сервис находится в состоянии проблемы, `status` равен либо:<br>- серьезности наиболее критичной проблемы;<br>- наивысшему статусу дочернего сервиса в состоянии проблемы.<br><br>Если сервис находится в состоянии OK, `status` равен -1.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|description|string|Описание сервиса.|
|uuid|string|Универсальный уникальный идентификатор, используемый для связывания импортированных сервисов с уже существующими. Автоматически генерируется, если не указан.|
|created_at|integer|Unix timestamp, когда сервис был создан.|
|readonly|integer|Доступ к сервису.<br><br>Возможные значения:<br>0 - Чтение и запись;<br>1 - Только чтение.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|

[comment]: # ({/92b0166a-5d7a3d70})

[comment]: # ({dd16f497-c2041847})
### Правило статуса

Объект правила статуса имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|Условие для установки статуса (New status).<br><br>Возможные значения:<br>0 - если как минимум (N) дочерних сервисов имеют статус (Status) или выше;<br>1 - если как минимум (N%) дочерних сервисов имеют статус (Status) или выше;<br>2 - если менее (N) дочерних сервисов имеют статус (Status) или ниже;<br>3 - если менее (N%) дочерних сервисов имеют статус (Status) или ниже;<br>4 - если вес дочерних сервисов со статусом (Status) или выше составляет не менее (W);<br>5 - если вес дочерних сервисов со статусом (Status) или выше составляет не менее (N%);<br>6 - если вес дочерних сервисов со статусом (Status) или ниже меньше (W);<br>7 - если вес дочерних сервисов со статусом (Status) или ниже меньше (N%).<br><br>Где:<br>- N (W) — `limit_value`;<br>- (Status) — `limit_status`;<br>- (New status) — `new_status`.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|limit\_value|integer|Предельное значение.<br><br>Возможные значения:<br>- для N и W: 1-100000;<br>- для N%: 1-100.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|limit\_status|integer|Предельный статус.<br><br>Возможные значения:<br>-1 - OK;<br>0 - Не классифицировано;<br>1 - Информация;<br>2 - Предупреждение;<br>3 - Средняя;<br>4 - Высокая;<br>5 - Катастрофа.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|new\_status|integer|Значение нового статуса.<br><br>Возможные значения:<br>0 - Не классифицировано;<br>1 - Информация;<br>2 - Предупреждение;<br>3 - Средняя;<br>4 - Высокая;<br>5 - Катастрофа.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/dd16f497-c2041847})

[comment]: # ({72128b59-c301cfb2})
### Тег сервиса

Объект тега сервиса имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Имя тега сервиса.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Значение тега сервиса.|

[comment]: # ({/72128b59-c301cfb2})

[comment]: # ({56809270-e6daa7b4})
### Сигнализация сервиса

::: noteclassic
Сигнализации сервиса нельзя напрямую создавать, обновлять или
удалять через Zabbix API.
:::

Объекты сигнализации сервиса представляют изменение состояния сервиса. Они имеют
следующие свойства.

|Property |[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|clock|timestamp|Время, когда произошло изменение состояния сервиса.|
|value|integer|Статус сервиса.<br><br>См. [свойство `status` сервиса](object#service) для списка возможных значений.|

[comment]: # ({/56809270-e6daa7b4})

[comment]: # ({10d32ffb-6b88d3dc})
### Тег проблемы

Теги проблемы позволяют связывать услуги с событиями проблемы. Объект тега проблемы
имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Имя тега проблемы.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|operator|integer|Оператор условия сопоставления [operator](/manual/it_services/service_tree#service-configuration).<br><br>Возможные значения:<br>0 - *(default)* Равно;<br>2 - Содержит.|
|value|string|Значение тега проблемы.|

[comment]: # ({/10d32ffb-6b88d3dc})