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.

Parameter Type Description
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 hosts grupām.
hostids ID/array Atgriezt tikai brīdinājumus, ko ģenerējuši objekti no norādītajiem hosts.
mediatypeids ID/array Atgriezt tikai ziņojumu brīdinājumus, kas izmantoja norādītos mediju tipus.
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.

Skatiet notikuma object atbalstīto objektu tipu sarakstu.

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

Skatiet notikuma source atbalstīto notikumu tipu sarakstu.

Noklusējums: 0 - trigera 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 hosts datiem, kas aktivizēja darbības operāciju.
selectMediatypes query Atgriezt mediatypes īpašību ar masīvu, kurā ir mediju tipi, kas tika izmantoti ziņojuma brīdinājumam.

Skatiet mediatype.get lietotāja tipa ierobežojumiem.
selectUsers query Atgriezt users īpašību ar masīvu, kurā ir lietotāji, kuriem ziņojums tika adresēts.

Skatiet user.get lietotāja tipa ierobežojumiem.
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

Zabbix 7.0.9 versijā Admin un User tipa lietotāji var izgūt "message" (0) tipa brīdinājumu datus tikai par savu lietotāju.

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

Saņemt brīdinājumus pēc darbības ID

Saņemt visus brīdinājumus, kas ģenerēti ar darbību "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": "PROBLEM: Zabbix aģents uz Linux serveris nav sasniedzams 5 minūtes: ",
            "message": "Trigeris: Zabbix aģents uz Linux serveris nav sasniedzams 5 minūtes: \nTrigeris statuss: PROBLEM\nTrigeris smagums: 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.