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

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

[comment]: # ({2224f5b5-eed7fdda})
### 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.
-   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 den 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 ist für Benutzer aller Typen verfügbar.
Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle widerrufen werden.
Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/2224f5b5-eed7fdda})

[comment]: # ({2559b8ef-32560b88})
### Parameter

`(object/array)` Parameter, die die IDs der Ereignisse und die auszuführenden Update-Operationen enthalten.

|Parameter|[Typ](/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>[Verhalten des Parameters](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|
|action|integer|Aktion(en) zum Aktualisieren von Ereignissen.<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 - Ereignis nicht mehr bestätigen;<br>32 - Ereignis unterdrücken;<br>64 - Unterdrückung des Ereignisses aufheben;<br>128 - Ereignisrang auf Ursache ändern;<br>256 - Ereignisrang auf Symptom ändern.<br><br>Dies ist ein Bitmaskenfeld; jede Summe der möglichen Bitmap-Werte ist zulässig (z. B. 34 für Ereignis bestätigen und unterdrücken).<br><br>[Verhalten des Parameters](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|
|cause_eventid|ID|ID des Ursache-Ereignisses.<br><br>[Verhalten des Parameters](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*, wenn `action` das Bit "Ereignisrang auf Symptom ändern" enthält|
|message|string|Text der Nachricht.<br><br>[Verhalten des Parameters](/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>[Verhalten des Parameters](/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, erfolgt die Unterdrückung unbegrenzt.<br><br>[Verhalten des Parameters](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*, wenn `action` das Bit "Ereignis unterdrücken" enthält|

[comment]: # ({/2559b8ef-32560b88})

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

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

[comment]: # ({/2974bd26-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})