Documentation
Table of Contents
alert.get
Опис
integer/array alert.get(object parameters)
Метода омогућава преузимање упозорења према датим параметрима.
Овај метод је доступан корисницима било које врсте. Дозволе за позивање методе може се опозвати у подешавањима улоге корисника. Погледајте User roles за више информација.
Параметери
(object) Параметри који дефинишу жељени излаз.
Метод подржава следеће параметре.
| Parameter | Type | Description |
|---|---|---|
| alertids | ID/array | Враћа само упозорења са датим ID-ијевима. |
| actionids | ID/array | Враћа само упозорења генерисана датим акцијама. |
| eventids | ID/array | Враћа само упозорења генерисана датим догађајима. |
| groupids | ID/array | Враћа само упозорења генерисана од објеката од датих група домаћина. |
| hostids | ID/array | Враћа само упозорења генерисана од објеката датих домаћина. |
| mediatypeids | ID/array | Враћа само поруке упозорења које су користиле дате типове медија. |
| objectids | ID/array | Враћа само упозорења генерисана од датих објеката |
| userids | ID/array | Враћа само поруке упозорења које су послате датим корисницима. |
| eventobject | integer | Враћа само упозорења генерисана догађајима који се односе на објекте датог типа. Погледајте догађај object за листу подржаних типова објеката.Подразумевано: 0 - окидач. |
| eventsource | integer | Враћа само упозорења генерисана догађајима датог типа. Погледајте догађај source за листу подржаних типова догађаја .Подразумевано: 0 - окидач догађаја. |
| time_from | timestamp | Враћа само упозорења која су генерисана након датог времена. |
| time_till | timestamp | Враћа само упозорења која су генерисана пре датог времена. |
| selectHosts | query | Враћа својство hosts са подацима о домаћинима која су покренула операцију акције. |
| selectMediatypes | query | Враћа својство mediatypes са низом типова медија која су коришћена за поруку упозорења.Погледајте mediatype.get за ограничења заснована на типу корисника. |
| selectUsers | query | Враћа својство users са низом корисника којима је порука била упућена.Погледајте user.get за ограничења на основу типа корисника. |
| sortfield | string/array | Сортирај резултат према датим својствима. Могуће вредности: alertid, clock, eventid, mediatypeid, sendto, status. |
| countOutput | boolean | Ови параметри су описани у референтном коментару. |
| editable | boolean | |
| excludeSearch | boolean | |
| filter | object | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean |
У Zabbixу 7.0.9, корисници типа Администратор и Корисник могу да преузимају податке упозорења типа "порука" (0) само о свом кориснику.
Повратне вредности
(integer/array)Враћа или:
- низ објеката;
- број преузетих објеката, ако је параметар
countOutputкоришћен.
Примери
Преузми упозорења према ID-у акције
Преузми сва упозорења генерисана акцијом "3".
{ "jsonrpc": "2.0", "method": "alert.get", "params": { "output": "extend", "actionids": "3" }, "id": 1 }Одговор:
{ "jsonrpc": "2.0", "result": [ { "alertid": "1", "actionid": "3", "eventid": "21243", "userid": "1", "clock": "1362128008", "mediatypeid": "1", "sendto": "[email protected]", "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 }Погледајте такође
Извор
CAlert::get() у ui/include/classes/api/services/CAlert.php.