[comment]: # translation:outdated

[comment]: # ({834a65f7-9464a98f})
# 3.event.get

[comment]: # ({/834a65f7-9464a98f})

[comment]: # ({ef595334-7cdfc54d})
### 描述

`整数/数组 event.get(object parameters)`

此方法用于根据给定参数来获取事件。

[comment]: # ({/ef595334-7cdfc54d})

[comment]: # ({088ef824-a497b388})
### 参数

`(对象)` 定义所需输出的参数。

此方法支持以下参数：

|参数                     类|描述|<|
|------------------------------|------|-|
|eventids|string/array|仅返回具有给定ID的事件。|
|groupids|string/array|仅返回所属主机组的对象创建的事件。|
|hostids|string/array|仅返回所属主机的对象创建的事件。|
|objectids|string/array|仅返回由给定对象创建的事件。|
|applicationids|string/array|仅返回所属应用的对象创建的事件。仅当对象为触发器或监控项时才适用。|
|source|integer|仅返回给定类型的事件。<br><br>有关支持的事件类型的列表，请参阅[事件对象](object#event)页面.<br><br>默认值: 0 - 触发器事件。|
|object|integer|仅返回由给定类型的对象创建的事件。<br><br>有关支持的对象类型的列表，请参阅[事件对象](object#event)页面.<br><br>默认值: 0 - 触发器。|
|acknowledged|boolean|若设置为“true”，则只返回已被确认的事件。|
|severities|integer/array|仅返回符合所属严重程度的事件。仅当对象为触发器时才适用。|
|evaltype|integer|标签搜索的规则。<br><br>可能值:<br>0 - (默认) 与/或;<br>2 - 或。|
|tags|object|仅返回具有给定标签的事件。 按标签进行完全匹配，按值搜索时，不区分大小写。<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>一个空数组会返回所有事件。<br><br>可能的操作类型:<br>0 - (默认) 相似(like);<br>1 - 相等(equal)。|
|eventid\_from|string|仅返回ID大于或等于给定ID的事件。|
|eventid\_till|string|仅返回ID小于或等于给定ID的事件。|
|time\_from|timestamp|仅返回在给定时间时或之后创建的事件。|
|time\_till|timestamp|仅返回在给定时间时或之前创建的事件。|
|value|integer/array|仅返回具有给定值的事件。|
|selectHosts|query|在 `主机` 属性下，返回包含创建该事件的对象的主机. 仅支持由触发器、监控项、低级别发现规则生成的事件。|
|selectRelatedObject|query|在 `相关对象(relatedObject)` 属性下，返回创建该事件的对象。返回的对象类型会依赖于该事件的类型。|
|select\_alerts|query|在 `告警` 属性下，返回由该事件生成的告警，告警是按反向时间顺序进行排序。|
|select\_acknowledges|query|在 `确认` 属性下，返回事件的更新. 事件的更新是按反向时间顺序进行排序。<br><br>事件更新对象具有以下属性:<br>`acknowledgeid` - `(string)` 确认的ID;<br>`userid` - `(string)` 更新事件的用户的ID;<br>`eventid` - `(string)` 被更新事件的ID;<br>`clock` - `(timestamp)` 事件的更新时间;<br>`message` - `(string)` 消息文本;<br>`action` - `(integer)` 已执行的更新操作,参考[event.acknowledge](/zh/manual/api/reference/event/acknowledge);<br>`old_severity` - `(integer)` event severity before this update action更新操作之前的事件的严重等级;<br>`new_severity` - `(integer)` 更新操作之后的事件的严重等级;<br>`alias` - `(string)` alias of the user that updated the event更新该事件的用户的别名;<br>`name` - `(string)` 更新该事件的用户的名称;<br>`surname` - `(string)` 更新该事件的用户的姓氏.<br><br>支持 `计数(count)`。|
|selectTags|query|在 `标签` 属性下，返回事件的标签。|
|sortfield|string/array|根据给定属性，对结果进行排序。<br><br>可能值: `eventid`, `objectid` 以及 `clock`。|
|countOutput|boolean|以下参数为get方法通常参数，在[参考注释](/manual/api/reference_commentary#common_get_method_parameters)有详细说明。|
|editable|boolean|^|
|excludeSearch|boolean|^|
|filter|object|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/088ef824-a497b388})

[comment]: # ({536083cc-7223bab1})
### 返回值

`(整数/数组)` 返回:

-   一个数组对象;
-   如果使用了 `countOutput` 参数，返回获取对象的数值。

[comment]: # ({/536083cc-7223bab1})

[comment]: # ({4811a99c-b41637d2})
### 示例

[comment]: # ({/4811a99c-b41637d2})

[comment]: # ({164f2943-293872a4})
#### 获取触发器事件

从触发器"13926."中获取最新事件。

请求:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "event.get",
    "params": {
        "output": "extend",
        "select_acknowledges": "extend",
        "selectTags": "extend",
        "objectids": "13926",
        "sortfield": ["clock", "eventid"],
        "sortorder": "DESC"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

响应:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": [
        {
            "acknowledges": [
                {
                    "acknowledgeid": "1",
                    "userid": "1",
                    "eventid": "9695",
                    "clock": "1350640590",
                    "message": "Problem resolved.\n\r----[BULK ACKNOWLEDGE]----",
                    "action": "6",
                    "old_severity": "0",
                    "new_severity": "0",
                    "alias": "Admin",
                    "name": "Zabbix",
                    "surname": "Administrator"
                }
            ],
            "eventid": "9695",
            "source": "0",
            "object": "0",
            "objectid": "13926",
            "clock": "1347970410",
            "value": "1",
            "acknowledged": "1",
            "ns": "413316245",
            "name": "MySQL is down",
            "severity": "5",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "tags": [
                {
                    "tag": "service",
                    "value": "mysqld"
                },
                {
                    "tag": "error",
                    "value": ""
                }
            ]
        },
        {
            "acknowledges": [],
            "eventid": "9671",
            "source": "0",
            "object": "0",
            "objectid": "13926",
            "clock": "1347970347",
            "value": "0",
            "acknowledged": "0",
            "ns": "0",
            "name": "Unavailable by ICMP ping",
            "severity": "4",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "tags": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/164f2943-293872a4})

[comment]: # ({7ac07ed0-adbe5436})
#### 按时间段获取事件

在2012-10-9至2012-10-10时间段内，以反向时间顺序获取所有已被创建的事件。

请求:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "event.get",
    "params": {
        "output": "extend",
        "time_from": "1349797228",
        "time_till": "1350661228",
        "sortfield": ["clock", "eventid"],
        "sortorder": "desc"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

响应:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "20616",
            "source": "0",
            "object": "0",
            "objectid": "14282",
            "clock": "1350477814",
            "value": "1",
            "acknowledged": "0",
            "ns": "0",
            "name": "Less than 25% free in the history cache",
            "severity": "3",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0"
        },
        {
            "eventid": "20617",
            "source": "0",
            "object": "0",
            "objectid": "14283",
            "clock": "1350477814",
            "value": "0",
            "acknowledged": "0",
            "ns": "0",
            "name": "Zabbix trapper processes more than 75% busy",
            "severity": "3",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0"
        },
        {
            "eventid": "20618",
            "source": "0",
            "object": "0",
            "objectid": "14284",
            "clock": "1350477815",
            "value": "1",
            "acknowledged": "0",
            "ns": "0",
            "name": "High ICMP ping loss",
            "severity": "3",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0"
        }
    ],
    "id": 1
}
```

[comment]: # ({/7ac07ed0-adbe5436})

[comment]: # ({2a177be5-c6eb3ba0})
### 参考

-   [Alert](/manual/api/reference/alert/object)
-   [Item](/manual/api/reference/item/object)
-   [Host](/manual/api/reference/host/object)
-   [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule)
-   [Trigger](/manual/api/reference/trigger/object)
-   [告警](/zh/manual/api/reference/alert/object)
-   [监控项](/zh/manual/api/reference/item/object)
-   [主机](/zh/manual/api/reference/host/object)
-   [低级别发现规则](/zh/manual/api/reference/discoveryrule/object#lld_rule)
-   [触发器](/zh/manual/api/reference/trigger/object)

[comment]: # ({/2a177be5-c6eb3ba0})

[comment]: # ({ba142570-f85dc7ca})
### 来源

CEvent::get() in
*frontends/php/include/classes/api/services/CEvent.php*.

[comment]: # ({/ba142570-f85dc7ca})