[comment]: # ({2ccfd922-2ccfd922})
# event.acknowledge

[comment]: # ({/2ccfd922-2ccfd922})

[comment]: # ({07725e16-eed7fdda})
### Beschreibung

`object event.acknowledge(object/array parameters)`

Mit dieser Methode können Sie Ereignisse aktualisieren. Folgende Aktualisierungsaktionen können durchgefü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.
-   Ereignisschweregrad ä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.

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

::: noteclassic
Diese Methode steht Benutzern aller Typen zur Verfügung. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/07725e16-eed7fdda})

[comment]: # ({813f39be-32560b88})
### Parameter

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

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|eventids|ID/array|IDs der [Ereignisse](/manual/api/reference/event/object#event), die bestätigt werden sollen.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|
|action|integer|Aktion(en) zur Ereignisaktualisierung.<br><br>Mögliche Bitmap-Werte:<br>1 - Problem schließen;<br>2 - Ereignis bestätigen;<br>4 - Nachricht hinzufügen;<br>8 - Schweregrad ändern;<br>16 - Bestätigung des Ereignisses aufheben;<br>32 - Ereignis unterdrücken;<br>64 - Unterdrückung des Ereignisses aufheben;<br>128 - Ereignisrang in Ursache ändern;<br>256 - Ereignisrang in Symptom ändern.<br><br>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).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|
|cause_eventid|ID|ID des Ursache-Ereignisses.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*, wenn `action` das Bit „Ereignisrang in Symptom ändern“ enthält|
|message|string|Text der Nachricht.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*, wenn `action` das Bit „Nachricht hinzufügen“ enthält|
|severity|integer|Neuer Schweregrad für Ereignisse.<br><br>Mögliche Werte:<br>0 - nicht klassifiziert;<br>1 - Information;<br>2 - Warnung;<br>3 - durchschnittlich;<br>4 - hoch;<br>5 - Katastrophe.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*, wenn `action` das Bit „Schweregrad ändern“ enthält|
|suppress_until|integer|Unix-Zeitstempel, bis zu dem das Ereignis unterdrückt werden muss.<br><br>Wenn auf „0“ gesetzt, ist die Unterdrückung unbegrenzt.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*, wenn `action` das Bit „Ereignis unterdrücken“ enthält|

[comment]: # ({/813f39be-32560b88})

[comment]: # ({94f3ab84-94f3ab84})
### Rückgabewerte

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

[comment]: # ({/94f3ab84-94f3ab84})

[comment]: # ({b41637d2-b41637d2})
### Beispiele

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({2aa7a118-9e923e4c})
#### Bestätigen eines Ereignisses

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

[Anfrage](/manual/api#performing-requests):

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

Antwort:

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

[comment]: # ({/2aa7a118-9e923e4c})

[comment]: # ({63d8190d-94e25d7e})
#### Ändern des Schweregrads eines Ereignisses

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

[Anfrage](/manual/api#performing-requests):

```json
{
    "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:

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

[comment]: # ({/63d8190d-94e25d7e})

[comment]: # ({aadd99f7-aadd99f7})
### Quelle

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

[comment]: # ({/aadd99f7-aadd99f7})