[comment]: # aside: 1

[comment]: # ({195463c3-8bbba5df})
# Объект триггера

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

[comment]: # ({/195463c3-8bbba5df})

[comment]: # ({44461ee2-db828bca})
### Триггер

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|triggerid|ID|ID триггера.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*<br>- *обязательно* для операций обновления|
|description|string|Имя триггера.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|expression|string|Выражение триггера.<br><br>Элементы данных с `value_type`, установленным в `5` (binary), нельзя использовать в выражениях триггера.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|event\_name|string|Имя события, создаваемого триггером.|
|opdata|string|Операционные данные.|
|comments|string|Дополнительное описание триггера.|
|error|string|Текст ошибки, если при обновлении состояния триггера возникли проблемы.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|flags|integer|[Происхождение](/manual/api/reference_commentary#entity-origin-flags) триггера.<br><br>Возможные значения:<br>0 - *(по умолчанию)* обычный триггер;<br>4 - триггер, преобразованный из прототипа.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|lastchange|timestamp|Время последнего изменения состояния триггера.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|priority|integer|Серьезность триггера.<br><br>Возможные значения:<br>0 - *(по умолчанию)* не классифицировано;<br>1 - информация;<br>2 - предупреждение;<br>3 - средняя;<br>4 - высокая;<br>5 - катастрофа.|
|state|integer|Состояние триггера.<br><br>Возможные значения:<br>0 - *(по умолчанию)* состояние триггера актуально;<br>1 - текущее состояние триггера неизвестно.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|status|integer|Включен или отключен триггер.<br><br>Возможные значения:<br>0 - *(по умолчанию)* включен;<br>1 - отключен.|
|templateid|ID|ID родительского триггера шаблона.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|type|integer|Может ли триггер генерировать несколько событий проблемы.<br><br>Возможные значения:<br>0 - *(по умолчанию)* не генерировать несколько событий;<br>1 - генерировать несколько событий.|
|url|string|URL, связанный с триггером.|
|url_name|string|Метка для URL, связанного с триггером.|
|value|integer|Находится ли триггер в состоянии OK или проблемы.<br><br>Возможные значения:<br>0 - *(по умолчанию)* OK;<br>1 - проблема.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|recovery\_mode|integer|Режим генерации события OK.<br><br>Возможные значения:<br>0 - *(по умолчанию)* выражение;<br>1 - выражение восстановления;<br>2 - нет.|
|recovery\_expression|string|Выражение восстановления триггера.<br><br>Элементы данных с `value_type`, установленным в `5` (binary), нельзя использовать в выражениях восстановления триггера.|
|correlation\_mode|integer|Закрытие события OK.<br><br>Возможные значения:<br>0 - *(по умолчанию)* все проблемы;<br>1 - все проблемы, если значения тегов совпадают.|
|correlation\_tag|string|Тег для сопоставления.|
|manual\_close|integer|Разрешить ручное закрытие.<br><br>Возможные значения:<br>0 - *(по умолчанию)* нет;<br>1 - да.|
|uuid|string|Универсальный уникальный идентификатор, используемый для связывания импортированных триггеров с уже существующими. Если не указан, генерируется автоматически.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *поддерживается*, если триггер принадлежит шаблону|

[comment]: # ({/44461ee2-db828bca})

[comment]: # ({5a130da9-0188f389})
### Тег триггера

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

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

[comment]: # ({/5a130da9-0188f389})