event.acknowledge

Beschreibung

object event.acknowledge(object/array parameters)

Mit dieser Methode können Ereignisse aktualisiert werden. Die folgenden Aktualisierungsaktionen können durchgeführt werden:

  • Ereignis schließen. Wenn das Ereignis bereits behoben ist, wird diese Aktion übersprungen.
  • Ereignis quittieren. Wenn das Ereignis bereits quittiert ist, wird diese Aktion übersprungen.
  • Quittierung des Ereignisses aufheben. Wenn das Ereignis nicht quittiert ist, wird diese Aktion übersprungen.
  • Nachricht hinzufügen.
  • Schweregrad des Ereignisses ändern. Wenn das Ereignis bereits denselben Schweregrad hat, wird diese Aktion übersprungen.
  • Ereignis unterdrücken. Wenn das Ereignis bereits unterdrückt ist, wird diese Aktion übersprungen.
  • Unterdrückung des Ereignisses aufheben. Wenn das Ereignis nicht unterdrückt ist, wird diese Aktion übersprungen.
  • Ereignisrang auf Ursache ändern. Wenn das Ereignis bereits als Ursache eingestuft ist, wird diese Aktion übersprungen.
  • Ereignisrang auf Symptom ändern. Wenn das Ereignis bereits als Symptom eingestuft ist, wird diese Aktion übersprungen.

Nur Auslöser-Ereignisse können aktualisiert werden.
Nur Problemereignisse können aktualisiert werden.
Lese-/Schreibrechte für den Auslöser sind erforderlich, um das Ereignis zu schließen oder den Schweregrad des Ereignisses zu ändern.
Um ein Ereignis zu schließen, muss das manuelle Schließen im Auslöser erlaubt sein.

Diese Methode ist für Benutzer aller Typen verfügbar. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Parameter, die die IDs der Ereignisse und die Aktualisierungsvorgänge enthalten, die durchgeführt werden sollen.

Parameter Type Beschreibung
eventids ID/array IDs der Ereignisse, die bestätigt werden sollen.

Parameter behavior:
- erforderlich
action integer Aktion(en) zur Ereignisaktualisierung.

Mögliche Bitmap-Werte:
1 - Problem schließen;
2 - Ereignis bestätigen;
4 - Nachricht hinzufügen;
8 - Schweregrad ändern;
16 - Bestätigung des Ereignisses aufheben;
32 - Ereignis unterdrücken;
64 - Unterdrückung des Ereignisses aufheben;
128 - Ereignisrang in Ursache ändern;
256 - Ereignisrang in Symptom ändern.

Dies ist ein Bitmaskenfeld; jede Summe der möglichen Bitmap-Werte ist zulässig (zum Beispiel 34 für das Bestätigen und Unterdrücken eines Ereignisses).

Parameter behavior:
- erforderlich
cause_eventid ID ID des Ursache-Ereignisses.

Parameter behavior:
- erforderlich, wenn action das Bit „Ereignisrang in Symptom ändern“ enthält
message string Text der Nachricht.

Parameter behavior:
- erforderlich, wenn action das Bit „Nachricht hinzufügen“ enthält
severity integer Neuer Schweregrad für Ereignisse.

Mögliche Werte:
0 - nicht klassifiziert;
1 - Information;
2 - Warnung;
3 - durchschnittlich;
4 - hoch;
5 - Katastrophe.

Parameter behavior:
- erforderlich, wenn action das Bit „Schweregrad ändern“ enthält
suppress_until integer Unix-Zeitstempel, bis zu dem das Ereignis unterdrückt werden muss.

Wenn auf „0“ gesetzt, ist die Unterdrückung unbegrenzt.

Parameter behavior:
- erforderlich, wenn action das Bit „Ereignis unterdrücken“ enthält

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Ereignisse unter der Eigenschaft eventids enthält.

Beispiele

Bestätigen eines Ereignisses

Bestätigen Sie ein einzelnes Ereignis und hinterlassen Sie eine Nachricht.

Anfrage:

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

Antwort:

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

Ändern des Schweregrads eines Ereignisses

Ändern Sie den Schweregrad für mehrere Ereignisse und hinterlassen Sie eine Nachricht.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Wartung erforderlich, um das Problem zu beheben.",
        "severity": 4
    },
    "id": 1
}

Antwort:

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

Quelle

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