[comment]: # aside: 1
[comment]: # translation:outdated
[comment]: # ({195463c3-8bbba5df})
# 触发器对象
以下对象与`trigger`API直接相关.
[comment]: # ({/195463c3-8bbba5df})
[comment]: # ({6488ae52-db828bca})
### 触发器
触发器对象具有以下属性.
| 属性| [类型](/manual/api/reference_commentary#data_types) | 描述 |
| ------ | ------ | ------ |
| triggerid | string| *(只读)* 触发器的ID. |
| **description**
(必须) | string| 触发器的名称.|
| **expression**
(必须)| string| 简化的触发器表达式.|
| event\_name | string| 生成触发器的事件名称.|
| opdata| string| 当前的数据.|
| comments| string| 触发器的附加说明.|
| error | string| *(只读)* 更新触发器状态时出现的任何问题的错误文本. |
| flags | integer | *(只读)* 原始触发器.
有效的值为:
0 - *(默认)* 普通触发器;
4 - 自动发现的触发器. |
| lastchange| timestamp | *(只读)* 触发器最后更改其状态的时间. |
| priority| integer | 触发器的严重性级别.
有效的值为:
0 - *(默认)* 未分类;
1 - 信息;
2 - 警告;
3 - 一般严重;
4 - 严重;
5 - 灾难. |
| state | integer | *(只读)* 触发器的状态.
有效的值为:
0 - *(默认)* 触发器状态是最新的;
1 - 当前的触发器状态是未知的. |
| status| integer | 触发器是否处于启用状态或禁用状态.
有效的值为:
0 - *(默认)* 已启用;
1 - 已禁用. |
| templateid| string| *(只读)* 父触发器模板ID. |
| type| integer | 触发器是否能够生成多个问题事件.
有效的值为:
0 - *(默认)* 不能生成多个事件;
1 - 可以生成多个事件. |
| url | string| 与触发器相关联的URL. |
| value | integer | *(只读)* 触发器是否处于正常或问题状态.
有效的值为:
0 - *(默认)* 正常状态;
1 - 问题状态. |
| recovery\_mode| integer | 事件恢复生成模式.
有效的值为:
0 - *(默认)* 表达式;
1 - 恢复表达式;
2 - 无. |
| recovery\_expression| string| 简化的触发恢复表达式.|
| correlation\_mode | integer | 事件恢复关联的模式.
有效的值为:
0 - *(默认)* 所有问题;
1 - 与标签值匹配的所有问题. |
| correlation\_tag| string| 用于匹配的标签.|
| manual\_close | integer | 允许手动关闭.
有效的值为:
0 - *(默认)* 不允许;
1 - 允许. |
| uuid| string| 通用唯一标识符，用于将导入的触发器链接到已经存在的触发器，仅用于模板上的触发器，如果没有提前给出则标识符会自动生成.
此字段是 *只读的*，不能通过更新操作修改已有标识符. |
注意，对于某些方法（更新、删除），必需/可选参数组合是不同的。
[comment]: # ({/6488ae52-db828bca})
[comment]: # ({93a45a02-0188f389})
### 触发器标签
触发标签对象具有以下属性.
| 属性 | [类型](/manual/api/reference_commentary#data_types) | 描述 |
| --------------------- | --------------------------------------------------- | ----------------- |
| **tag**
(required) | string | 触发器的标签名称. |
| value | string | 触发器的标签值. |
[comment]: # ({/93a45a02-0188f389})