[comment]: # translation:outdated

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

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

[comment]: # ({6dd59d4b-ed55724c})
### Опис

`integer/array alert.get(object parameters)`

Метод дозволяє отримувати оповіщення за заданими параметрами.

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

[comment]: # ({/6dd59d4b-ed55724c})

[comment]: # ({88f25540-218fa8cf})

### Параметри

`(object)` Параметри, що визначають бажаний результат.

Метод підтримує такі параметри.

|Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис|
|--|--|------|
|alertids|string/array|Повертати лише сповіщення з указаними ідентифікаторами.|
|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>Перегляньте подію ["джерело"](/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).|
|editable|boolean|^|
|excludeSearch|boolean|^|
|filter|object|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

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

[comment]: # ({7223bab1-7223bab1})
### Повернуті значення

`(integer/array)` Повертає або:

- масив об'єктів;
- кількість отриманих об'єктів, якщо використовувався параметр `countOutput`.

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

[comment]: # ({b41637d2-b41637d2})
### Приклади

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

[comment]: # ({161b0eb6-8d56d57c})
#### Отримувати сповіщення за ідентифікатором дії

Отримати всі сповіщення, згенеровані дією «3».

Запит:

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

Відповідь:

```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]: # ({/161b0eb6-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})