event.acknowledge

Beschreibung

object event.acknowledge(object/array parameters)

Diese Methode ermöglicht es Ihnen, Ereignisse zu aktualisieren. Die folgenden Aktualisierungsaktionen können ausgeführt werden:

  • Ereignis schließen. Wenn das Ereignis bereits behoben ist, wird diese Aktion übersprungen.
  • Ereignis bestätigen. Wenn das Ereignis bereits bestätigt ist, wird diese Aktion übersprungen.
  • Bestätigung des Ereignisses aufheben. Wenn das Ereignis nicht bestätigt 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.
  • Ereignisbewertung auf Ursache ändern. Wenn das Ereignis bereits als Ursache eingestuft ist, wird diese Aktion übersprungen.
  • Ereignisbewertung auf Symptom ändern. Wenn das Ereignis bereits als Symptom eingestuft ist, wird diese Aktion übersprungen.

Es können nur Auslöser-Ereignisse aktualisiert werden.
Es können nur Problemereignisse 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. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle widerrufen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Parameter mit den IDs der Ereignisse und Aktualisierungsvorgängen, die ausgeführt werden sollen.

Parameter Typ Beschreibung
eventids ID/array IDs der zu bestätigenden Ereignisse.

Parameterverhalten:
- erforderlich
action integer Aktion(en) zur Aktualisierung des Ereignisses.

Mögliche Bitmaskenwerte:
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 - Rang des Ereignisses in Ursache ändern;
256 - Rang des Ereignisses in Symptom ändern.

Dies ist ein Bitmaskenfeld; jede Summe möglicher Bitmaskenwerte ist zulässig (zum Beispiel 6 zum Bestätigen eines Ereignisses und Hinterlassen einer Nachricht oder 34 zum Bestätigen und Unterdrücken eines Ereignisses).

Parameterverhalten:
- erforderlich
cause_eventid ID ID des Ursache-Ereignisses.

Parameterverhalten:
- erforderlich, wenn action das Bit „Rang des Ereignisses in Symptom ändern“ enthält
message string Text der Nachricht.

Parameterverhalten:
- 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.

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

Wenn der Wert auf „0“ gesetzt wird, ist die Unterdrückung unbefristet.

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

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Ereignisse in 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
}

Unterdrücken eines Ereignisses auf unbestimmte Zeit

Unterdrücken Sie ein einzelnes Ereignis ohne Ablaufzeit.

Anfrage:

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

Antwort:

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

Aufhebung der Unterdrückung eines Ereignisses

Hebt die Unterdrückung eines einzelnen zuvor unterdrückten Ereignisses auf.

Anfrage:

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

Antwort:

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

Ein Ereignis bestätigen und unterdrücken

Bestätigen Sie ein oder mehrere Ereignisse, fügen Sie eine Nachricht hinzu und unterdrücken Sie sie in derselben Anfrage.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": [
            "20427",
            "20428"
        ],
        "action": 38,
        "message": "Unterdrückung während geplanter Wartung.",
        "suppress_until": 0
    },
    "id": 1
}

Antwort:

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

Quelle

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