[comment]: # translation:outdated

[comment]: # ({4c82c7ad-4c82c7ad})
# alert.get

[comment]: # ({/4c82c7ad-4c82c7ad})

[comment]: # ({3c5ac067-ed55724c})
### Описание

`integer/array alert.get(параметры объекта)`

Метод позволяет получать оповещения по заданным параметрам.

::: noteclassic
Этот метод доступен пользователям любого типа.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/3c5ac067-ed55724c})

[comment]: # ({fda1f396-218fa8cf})
### Параметры

`(object)` Параметры определяющие желаемый результат.

Метод поддерживает следующие параметры.

|Параметр|[Тип](/manual/api/reference_commentary#data_types)|Описание|
|--|--|------|
|alertids|string/array|Возвращает только оповещения с заданными IDs.|
|actionids|string/array|Возвращает только оповещения, созданные указанными действиями.|
|eventids|string/array|Возвращает только оповещения, созданные указанными событиями.|
|groupids|string/array|Возвращает только оповещения, созданные объектами из заданных групп узлов сети.|
|hostids|string/array|Возвращает только оповещения, созданные объектами с заданных узлов сети.|
|mediatypeids|string/array|Возвращать только сообщения оповещений в которых использовались заданные способы оповещений.|
|objectids|string/array|Возвращает только оповещения созданные указанными объектами|
|userids|string/array|Возвращает только сообщения оповещений которые были отправлены указанным пользователям.|
|eventobject|integer|Возвращает только оповещения созданные событиями связанными с объектами данного типа.<br><br>См. список событий ["object"](/manual/api/reference/event/object#event) поддерживаемые типы объектов.<br><br>По умолчанию: 0 - триггер.|
|eventsource|integer|Возвращает только оповещения, созданные событиями заданного типа.<br><br>См. список поддерживаемых типов событий в событии ["source"](/manual/api/reference/event/object#event) .<br><br>По умолчанию: 0 – события оповещений.|
|time\_from|timestamp|Возвращает только оповещения, созданные после указанного времени.|
|time\_till|timestamp|Возвращает только оповещения, созданные до указанного времени.|
|selectHosts|query|Возвращает свойство [hosts](/manual/api/reference/host/object) с данными узлов сети которые инициировали операцию действия.|
|selectMediatypes|query|Возвращает свойство [mediatypes](/manual/api/reference/mediatype/object) с массивом способов оповещений, которые использовались для сообщения оповещения.|
|selectUsers|query|Возвращает свойство [users](/manual/api/reference/user/object) с массивом пользователей которым было адресовано сообщение.|
|sortfield|string/array|Сортировать результат по заданным свойствам.<br><br>Возможные значения: `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto` и `status`.| 
|countOutput|boolean|Эти параметры являются общими для всех методов `get` и описаны в [справочных комментариях](/manual/api/reference_commentary#common_get_method_parameters).|
|редактируемый|boolean|^|
|excludeSearch|boolean|^|
|filter|object|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/fda1f396-218fa8cf})

[comment]: # ({7223bab1-7223bab1})
### Возвращаемые значения

`(integer/array)` Возвращает:

- · массив объектов;
- · количество извлеченных объектов, если использовался параметр `countOutput`.

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

[comment]: # ({b41637d2-b41637d2})
### Примеры

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

[comment]: # ({d2314193-8d56d57c})
#### Получение предупреждений по ID действия

Получить все оповещения, созданные действием "3".

Request:

```json
{
 · "jsonrpc": "2.0",
 · "method": "alert.get",
 · "params": {
 · "output": "extend",
 · "actionids": "3"
 · },
 · "auth": "038e1d7b1735c6a5436ee9eae095879e",
 · "id": 1
}
```

Response:

```json
{
 · "jsonrpc": "2.0",
 · "result": [
 · {
 · "alertid": "1",
 · "actionid": "3",
 · "eventid": "21243",
 · "userid": "1",
 · "clock": "1362128008",
 · "mediatypeid": "1",
 · "sendto": "support@company.com",
 · "subject": "PROBLEM: Zabbix agent on Linux server is unreachable for 5 minutes: ",
 · "message": "Trigger: Zabbix agent on Linux server is unreachable for 5 minutes: \nTrigger status: PROBLEM\nTrigger severity: Not classified",
 · "status": "0",
 · "retries": "3",
 · "error": "",
 · "esc_step": "1",
 · "alerttype": "0",
 · "p_eventid": "0",
 · "acknowledgeid": "0"
 · }
 · ],
 · "id": 1
}
```

[comment]: # ({/d2314193-8d56d57c})

[comment]: # ({5371aed2-5371aed2})
### Смотрите также

- · [Узел сети](/manual/api/reference/host/object#host)
- · [Способ оповещения](/manual/api/reference/mediatype/object#media_type)
- · [Пользователь](/manual/api/reference/user/object#user)

[comment]: # ({/5371aed2-5371aed2})

[comment]: # ({14a85885-14a85885})
### Источник

CAlert::get() в *ui/include/classes/api/services/CAlert.php*.

[comment]: # ({/14a85885-14a85885})