[comment]: # aside: 1
[comment]: # ({195463c3-8bbba5df})
# 触发器对象
以下对象与`trigger`API直接相关.
[comment]: # ({/195463c3-8bbba5df})
[comment]: # ({5bafdb04-db828bca})
### 触发器
触发器对象具有以下属性。
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|triggerid|ID|触发器的 ID。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*
- 更新操作时 *必填*|
|description|string|触发器名称。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- 创建操作时 *必填*|
|expression|string|触发器表达式。
`value_type` 设置为 `5`（二进制）或 `6`（JSON）的监控项不能在触发器表达式中使用。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- 创建操作时 *必填*|
|event\_name|string|由触发器生成的事件名称。|
|opdata|string|运行数据。|
|comments|string|触发器的附加描述。|
|error|string|如果在更新触发器状态时出现任何问题，则为错误文本。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*|
|flags|integer|触发器的[来源](/manual/api/reference_commentary#entity-origin-flags)。
可能的值：
0 - *（默认）* 普通触发器；
4 - 由原型转换而来的触发器。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*|
|lastchange|timestamp|触发器上次更改其状态的时间。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*|
|priority|integer|触发器的严重性。
可能的值：
0 - *（默认）* 未分类；
1 - 信息；
2 - 警告；
3 - 一般严重；
4 - 高；
5 - 灾难。|
|state|integer|触发器表达式的[状态](/manual/config/triggers/expression#unknown-expression-state)。
可能的值：
0 - *（默认）* 触发器状态为最新；
1 - 当前触发器状态未知。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*|
|status|integer|触发器是启用还是禁用。
可能的值：
0 - *（默认）* 启用；
1 - 禁用。|
|templateid|ID|父模板触发器的 ID。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*|
|type|integer|触发器是否可以生成多个问题事件。
可能的值：
0 - *（默认）* 不生成多个事件；
1 - 生成多个事件。|
|url|string|与触发器关联的 URL。|
|url_name|string|与触发器关联的 URL 标签。|
|value|integer|触发器是否处于 OK 或问题状态。
可能的值：
0 - *（默认）* OK；
1 - 问题。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*|
|recovery\_mode|integer|OK 事件生成模式。
可能的值：
0 - *（默认）* 表达式；
1 - 恢复表达式；
2 - 无。|
|recovery\_expression|string|触发器恢复表达式。
`value_type` 设置为 `5`（二进制）或 `6`（JSON）的监控项不能在触发器恢复表达式中使用。|
|correlation\_mode|integer|OK 事件关闭方式。
可能的值：
0 - *（默认）* 所有问题；
1 - 当标签值匹配时关闭所有问题。|
|correlation\_tag|string|用于匹配的标签。|
|manual\_close|integer|允许手动关闭。
可能的值：
0 - *（默认）* 否；
1 - 是。|
|uuid|string|通用唯一标识符，用于将导入的触发器链接到已存在的触发器。如果未提供，则自动生成。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- 如果触发器属于模板，则 *支持*|
[comment]: # ({/5bafdb04-db828bca})
[comment]: # ({5d23ae4b-0188f389})
### 触发器标签
触发器标签对象具有以下属性。
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|触发器标签名称。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *必填*|
|value|string|触发器标签值。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*。|
|object|integer|标签继承自的对象类型。
可能的值：
0 - 模板；
1 - 主机；
3 - 监控项。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*。|
|objectid|ID|标签继承自的对象的 ID。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*。|
|automatic|integer|触发器标签的类型：
可能的值：
0 - *(默认)* 由用户创建的标签；
1 - 由 LLD 创建的标签；[属性行为](/manual/api/reference_commentary#property-behavior)：
- *只读*。|
[comment]: # ({/5d23ae4b-0188f389})