alert.get

Apraksts

integer/array alert.get(object parameters)

Šī metode ļauj izgūt brīdinājumus atbilstoši norādītajiem parametriem.

Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet Lietotāju lomas.

Parametri

(object) Parametri, kas nosaka vēlamo izvadi.

Metode atbalsta šādus parametrus.

Parametrs Tips Apraksts
alertids ID/array Atgriezt tikai brīdinājumus ar norādītajiem ID.
actionids ID/array Atgriezt tikai brīdinājumus, ko ģenerējušas norādītās darbības.
eventids ID/array Atgriezt tikai brīdinājumus, ko ģenerējuši norādītie notikumi.
groupids ID/array Atgriezt tikai brīdinājumus, ko ģenerējuši objekti no norādītajām hostu grupām.
hostids ID/array Atgriezt tikai brīdinājumus, ko ģenerējuši objekti no norādītajiem hostiem.
mediatypeids ID/array Atgriezt tikai ziņojumu brīdinājumus, kuros izmantoti norādītie mediju tipi.
objectids ID/array Atgriezt tikai brīdinājumus, ko ģenerējuši norādītie objekti
userids ID/array Atgriezt tikai ziņojumu brīdinājumus, kas tika nosūtīti norādītajiem lietotājiem.
eventobject integer Atgriezt tikai brīdinājumus, ko ģenerējuši notikumi, kas saistīti ar norādītā tipa objektiem.

Atbalstīto objektu tipu sarakstu skatiet notikuma object aprakstā.

Noklusējums: 0 - trigeris.
eventsource integer Atgriezt tikai brīdinājumus, ko ģenerējuši norādītā tipa notikumi.

Atbalstīto notikumu tipu sarakstu skatiet notikuma source aprakstā.

Noklusējums: 0 - trigeru notikumi.
time_from timestamp Atgriezt tikai brīdinājumus, kas ģenerēti pēc norādītā laika.
time_till timestamp Atgriezt tikai brīdinājumus, kas ģenerēti pirms norādītā laika.
selectHosts query Atgriezt hosts īpašību ar to hostu datiem, kas izraisīja darbības operāciju.
selectMediatypes query Atgriezt mediatypes īpašību ar mediju tipu masīvu, kas tika izmantoti ziņojuma brīdinājumam.

Skatiet mediatype.get lietotāja tipa ierobežojumus.
selectUsers query Atgriezt users īpašību ar to lietotāju masīvu, kuriem ziņojums bija adresēts.

Skatiet user.get lietotāja tipa ierobežojumus.
sortfield string/array Kārtot rezultātu pēc norādītajām īpašībām.

Iespējamās vērtības: alertid, clock, eventid, mediatypeid, sendto, status.
countOutput boolean Šie parametri ir aprakstīti atsauces komentārā.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Atgrieztās vērtības

(integer/array) Atgriež vienu no šīm vērtībām:

  • objektu masīvu;
  • izgūto objektu skaitu, ja ir izmantots parametrs countOutput.

Piemēri

Brīdinājumu izgūšana pēc darbības ID

Izgūst visus brīdinājumus, ko ģenerējusi darbība "3".

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "alert.get",
    "params": {
        "output": "extend",
        "actionids": "3"
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "alertid": "1",
            "actionid": "3",
            "eventid": "21243",
            "userid": "1",
            "clock": "1362128008",
            "mediatypeid": "1",
            "sendto": "[email protected]",
            "subject": "PROBLĒMA: Zabbix aģents Linux serverī nav sasniedzams 5 minūtes: ",
            "message": "Trigeris: Zabbix aģents Linux serverī nav sasniedzams 5 minūtes: \nTrigera stāvoklis: PROBLĒMA\nTrigera nozīmīgums: Nav klasificēts",
            "status": "0",
            "retries": "3",
            "error": "",
            "esc_step": "1",
            "alerttype": "0",
            "p_eventid": "0",
            "acknowledgeid": "0"
        }
    ],
    "id": 1
}

Skatiet arī

Avots

CAlert::get() failā ui/include/classes/api/services/CAlert.php.