event.acknowledge

Apraksts

object event.acknowledge(object/array parameters)

Šī metode ļauj atjaunināt notikumus. Var veikt šādas atjaunināšanas darbības:

  • Aizvērt notikumu. Ja notikums jau ir atrisināts, šī darbība tiks izlaista.
  • Apstiprināt notikumu. Ja notikums jau ir apstiprināts, šī darbība tiks izlaista.
  • Atcelt notikuma apstiprinājumu. Ja notikums nav apstiprināts, šī darbība tiks izlaista.
  • Pievienot ziņojumu.
  • Mainīt notikuma nopietnību. Ja notikumam jau ir tāda pati nopietnība, šī darbība tiks izlaista.
  • Apspiest notikumu. Ja notikums jau ir apspiests, šī darbība tiks izlaista.
  • Atcelt notikuma apspiešanu. Ja notikums nav apspiests, šī darbība tiks izlaista.
  • Mainīt notikuma rangu uz cēloni. Ja notikums jau ir klasificēts kā cēlonis, šī darbība tiks izlaista.
  • Mainīt notikuma rangu uz simptomu. Ja notikums jau ir klasificēts kā simptoms, šī darbība tiks izlaista.

Atjaunināt var tikai trigeru notikumus.
Atjaunināt var tikai problēmu notikumus.
Lai aizvērtu notikumu vai mainītu notikuma nopietnību, ir nepieciešamas trigerim piešķirtas lasīšanas/rakstīšanas tiesības.
Lai aizvērtu notikumu, trigerī jābūt atļautai manuālai aizvēršanai.

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

Parametri

(object/array) Parametri, kas satur to notikumu ID un atjaunināšanas darbības, kas jāveic.

Parameter Type Description
eventids ID/array To notikumu ID, kuri jāapstiprina.

Parametra darbība:
- obligāts
action integer Notikuma atjaunināšanas darbība(s).

Iespējamās bitkartes vērtības:
1 - aizvērt problēmu;
2 - apstiprināt notikumu;
4 - pievienot ziņojumu;
8 - mainīt smaguma pakāpi;
16 - atcelt notikuma apstiprinājumu;
32 - apspiest notikumu;
64 - atcelt notikuma apspiešanu;
128 - mainīt notikuma rangu uz cēloni;
256 - mainīt notikuma rangu uz simptomu.

Šis ir bitmaskas lauks; ir pieņemama jebkura iespējamo bitkartes vērtību summa (piemēram, 6, lai apstiprinātu notikumu un atstātu ziņojumu, vai 34, lai apstiprinātu un apspiestu notikumu).

Parametra darbība:
- obligāts
cause_eventid ID Cēloņa notikuma ID.

Parametra darbība:
- obligāts, ja action satur bitu "mainīt notikuma rangu uz simptomu"
message string Ziņojuma teksts.

Parametra darbība:
- obligāts, ja action satur bitu "pievienot ziņojumu"
severity integer Jaunā notikumu smaguma pakāpe.

Iespējamās vērtības:
0 - nav klasificēts;
1 - informācija;
2 - brīdinājums;
3 - vidēja;
4 - augsta;
5 - katastrofāla.

Parametra darbība:
- obligāts, ja action satur bitu "mainīt smaguma pakāpi"
suppress_until integer Unix laikspiedols, līdz kuram notikums ir jāapslāpē.

Ja iestatīta vērtība "0", apspiešana būs beztermiņa.

Parametra darbība:
- obligāts, ja action satur bitu "apspiest notikumu"

Atgrieztās vērtības

(object) Atgriež objektu, kas satur atjaunināto notikumu ID īpašībā eventids.

Piemēri

Notikuma apstiprināšana

Apstipriniet vienu notikumu un atstājiet ziņojumu.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 6,
        "message": "Problem resolved."
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "eventids": [
            "20427"
        ]
    },
    "id": 1
}

Notikuma nopietnības maiņa

Mainiet vairāku notikumu nopietnību un atstājiet ziņojumu.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Maintenance required to fix it.",
        "severity": 4
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "eventids": [
            "20427",
            "20428"
        ]
    },
    "id": 1
}

Notikuma slāpēšana uz nenoteiktu laiku

Slāpēt vienu notikumu bez derīguma termiņa.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 32,
        "suppress_until": 0
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "eventids": [
            20427
        ]
    },
    "id": 1
}

Notikuma atsaukšana no slāpēšanas

Atsauciet viena iepriekš slāpēta notikuma slāpēšanu.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 64
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "eventids": [
            20427
        ]
    },
    "id": 1
}

Apstiprināt un apspiest notikumu

Apstipriniet vienu vai vairākus notikumus, pievienojiet ziņojumu un apspiediet tos vienā un tajā pašā pieprasījumā.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": [
            "20427",
            "20428"
        ],
        "action": 38,
        "message": "Suppressing during planned maintenance.",
        "suppress_until": 0
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "eventids": [
            20427,
            20428
        ]
    },
    "id": 1
}

Avots

CEvent::acknowledge() failā ui/include/classes/api/services/CEvent.php.