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.
  • Noņemt 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.
  • Slāpēt notikumu. Ja notikums jau ir slāpēts, šī darbība tiks izlaista.
  • Noņemt notikuma slāpēšanu. Ja notikums nav slāpēts, šī darbība tiks izlaista.
  • Mainīt notikuma rangu uz cēloni. Ja notikums jau ir ierindots kā cēlonis, šī darbība tiks izlaista.
  • Mainīt notikuma rangu uz simptomu. Ja notikums jau ir ierindots kā simptoms, šī darbība tiks izlaista.

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

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

Parametri

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

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

Parametra uzvedība:
- required
action integer Notikuma atjaunināšanas darbība(-as).

Iespējamās bitkartes vērtības:
1 - aizvērt problēmu;
4 - pievienot ziņojumu;
6 - apstiprināt notikumu;
8 - mainīt smagumu;
16 - noņemt notikuma apstiprinājumu;
32 - slāpēt notikumu;
64 - noņemt notikuma slāpēšanu;
128 - mainīt notikuma rangu uz cēloni;
256 - mainīt notikuma rangu uz simptomu.

Šis ir bitmaskas lauks; ir pieļaujama jebkura iespējamo bitkartes vērtību summa (piemēram, 34, lai apstiprinātu un slāpētu notikumu).

Parametra uzvedība:
- required
cause_eventid ID Cēloņa notikuma ID.

Parametra uzvedība:
- required ja action satur bitu "mainīt notikuma rangu uz simptomu"
message string Ziņojuma teksts.

Parametra uzvedība:
- required ja action satur bitu "pievienot ziņojumu"
severity integer Jaunais notikumu smagums.

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

Parametra uzvedība:
- required ja action satur bitu "mainīt smagumu"
suppress_until integer Unix laikspiedols, līdz kuram notikums ir jāslāpē.

Ja iestatīts uz "0", slāpēšana būs beztermiņa.

Parametra uzvedība:
- required ja action satur bitu "slāpēt 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 atcelšana no slāpēšanas

Atceliet 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 slāpēt notikumu

Apstipriniet vienu vai vairākus notikumus, pievienojiet ziņojumu un slāpējiet tos vienā pieprasījumā.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": [
            "20427",
            "20428"
        ],
        "action": 38,
        "message": "Slāpēšana plānotas apkopes laikā.",
        "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.