[comment]: # aside: 1
[comment]: # ({c28d9843-bef38847})
# 事件对象
以下对象与 `event` API 直接相关。
[comment]: # ({/c28d9843-bef38847})
[comment]: # ({8fec61d9-355941f0})
### 事件
::: noteclassic
事件由 Zabbix 服务器创建，不能通过 API 修改。
:::
事件对象具有以下属性。
|属性|[类型](/manual/api/reference_commentary#data-types)|说明|
|--|--|------|
|eventid|ID|事件的 ID。|
|source|integer|事件类型。
可能的值：
0 - 由触发器创建的事件；
1 - 由发现规则创建的事件；
2 - 由活动 agent 自动注册创建的事件；
3 - 内部事件；
4 - 在服务状态更新时创建的事件。|
|object|integer|与事件相关的对象类型。
当 `source` 设置为“由触发器创建的事件”时，可能的值：
0 - 触发器。
当 `source` 设置为“由发现规则创建的事件”时，可能的值：
1 - 已发现的主机；
2 - 已发现的服务。
当 `source` 设置为“由活动 agent 自动注册创建的事件”时，可能的值：
3 - 自动注册的主机。
当 `source` 设置为“内部事件”时，可能的值：
0 - 触发器；
4 - 监控项；
5 - LLD 规则。
当 `source` 设置为“在服务状态更新时创建的事件”时，可能的值：
6 - 服务。|
|objectid|ID|相关对象的 ID。|
|acknowledged|integer|事件是否已确认。|
|clock|timestamp|事件创建时间。|
|ns|integer|事件创建时的纳秒值。|
|name|string|解析后的事件名称。|
|value|integer|相关对象的状态。
当 `source` 设置为“由触发器创建的事件”或“在服务状态更新时创建的事件”时，可能的值：
0 - OK；
1 - 问题。
当 `source` 设置为“由发现规则创建的事件”时，可能的值：
0 - 主机或服务正常；
1 - 主机或服务不可用；
2 - 主机或服务已发现；
3 - 主机或服务丢失。
当 `source` 设置为“内部事件”时，可能的值：
0 - “正常”状态；
1 - “未知”或“不支持”状态。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- 当 `source` 设置为“由触发器创建的事件”、“由发现规则创建的事件”、“内部事件”或“在服务状态更新时创建的事件”时，*supported*|
|severity|integer|事件当前严重性。
可能的值：
0 - 未分类；
1 - 信息；
2 - 警告；
3 - 一般；
4 - 严重；
5 - 灾难。|
|r\_eventid|ID|恢复事件的 ID。|
|c\_eventid|ID|在全局事件关联规则下，用于覆盖（关闭）当前事件的事件 ID。请参见 `correlationid` 以确定具体的关联规则。
仅当事件由全局事件关联规则关闭时，才会定义此参数。|
|cause_eventid|ID|原因事件的 ID。|
|correlationid|ID|生成问题关闭操作的关联规则 ID。
仅当事件由全局事件关联规则关闭时，才会定义此参数。|
|userid|ID|关闭事件的用户 ID（如果事件是手动关闭的）。|
|suppressed|integer|事件是否被抑制。
可能的值：
0 - 事件处于正常状态；
1 - 事件已被抑制。|
|opdata|string|带有已展开宏的运行数据。|
|urls|array|活动的[媒介类型 URL](/manual/api/reference/problem/object#media-type-url)。|
[comment]: # ({/8fec61d9-355941f0})
[comment]: # ({c550c09f-b89991b4})
### 事件标签
事件标签对象具有以下属性。
|属性|[类型](/manual/api/reference_commentary#data-types)|描述|
|--|--|------|
|tag|string|事件标签名称。|
|value|string|事件标签值。|
[comment]: # ({/c550c09f-b89991b4})
[comment]: # ({e47be315-52ff7df7})
### 媒介类型 URL
媒介类型 URL 对象具有以下属性。
|属性|[类型](/manual/api/reference_commentary#data-types)|描述|
|--|--|------|
|name|string|媒介类型中定义的 URL 名称。|
|url|string|媒介类型中定义的 URL 值。|
结果将仅包含处于活动状态且已启用事件菜单条目的媒介类型的条目。
属性中使用的宏将被展开，但如果其中一个属性包含未展开的宏，则这两个属性都将从结果中排除。
有关支持的宏，请参见 [*支持的宏*](/manual/appendix/macros/supported_by_location)。
[comment]: # ({/e47be315-52ff7df7})