event.acknowledge

Beschrijving

object event.acknowledge(object/array parameters)

Met deze methode kunnen gebeurtenissen worden bijgewerkt. De volgende update-acties kunnen: uitgevoerd:

  • Sluit evenement. Als de gebeurtenis al is opgelost, is deze actie: overgeslagen.
  • Erken gebeurtenis. Als de gebeurtenis al is bevestigd, deze actie zal worden overgeslagen.
  • Unacknowledge event. Als de gebeurtenis niet wordt bevestigd, wordt deze actie overgeslagen.
  • Bericht toevoegen.
  • De ernst van de gebeurtenis wijzigen. Als de gebeurtenis al dezelfde ernst heeft, is dit: actie wordt overgeslagen.

Alleen trigger gebeurtenissen kunnen worden bijgewerkt.
Alleen probleemgebeurtenissen kunnen worden bijgewerkt.
Lees-/schrijfrechten voor trigger zijn vereist om de gebeurtenis te sluiten of om de ernst van de gebeurtenis wijzigen.
Om een evenement te sluiten, moet handmatig sluiten zijn toegestaan in de trekker.

Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen, kan worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruiker rollen voor meer informatie.

Parameters

(object/array) Parameters met de ID's van de gebeurtenissen en update handelingen die moeten worden uitgevoerd.

Parameter Type Beschrijving
gebeurtenissen
(verplicht)		 string/object ID's van de te bevestigen gebeurtenissen.
actie
(vereist)		 geheel getal Actie(s) voor het bijwerken van gebeurtenissen. Dit is een bitmaskerveld, elke combinatie van waarden is acceptabel.

Mogelijke waarden:
1 - probleem sluiten;
2 - gebeurtenis bevestigen;
4 - bericht toevoegen;
8 - de ernst wijzigen;
16 - gebeurtenis ongedaan maken.
message string Tekst van het bericht.
Vereist, als actie de vlag 'bericht toevoegen' bevat.
severity integer Nieuwe ernst voor gebeurtenissen.
Vereist, als actie de vlag 'ernst wijzigen' bevat.

Mogelijke waarden:
0 - niet geclassificeerd;
1 - informatie;
2 - waarschuwing;
3 - gemiddeld;
4 - hoog;
5 - ramp.

Retourwaarden

(object) Retourneert een object dat de ID's van de bijgewerkte gebeurtenissen bevat onder de eigenschap 'eventids'.

Voorbeelden

Erkenning van een evenement

Erken een enkele gebeurtenis en laat een bericht achter.

Verzoek:

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

Antwoord:

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

De ernst van de gebeurtenis wijzigen

Wijzig de ernst voor meerdere gebeurtenissen en laat een bericht achter.

Verzoek:

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

Antwoord:

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

Bron

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