[comment]: # translation:outdated

[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.
-   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.

::: noteimportant
Es können nur Auslöser-Ereignisse aktualisiert werden.<br>
Es können nur Problemereignisse 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.
Die 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 der auszuführenden Aktualisierungsoperationen 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>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|
|action|integer|Aktion(en) zur Aktualisierung des Ereignisses.<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 - Ereignisbestätigung zurücknehmen;<br>32 - Ereignis unterdrücken;<br>64 - Unterdrückung des Ereignisses aufheben;<br>128 - Ereignis-Rang auf Ursache ändern;<br>256 - Ereignis-Rang auf Symptom ändern.<br><br>Dies ist ein Bitmaskenfeld; jede Summe der möglichen Bitmap-Werte ist zulässig (zum Beispiel 34 für Ereignis bestätigen und unterdrücken).<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*|
|cause_eventid|ID|ID des Ursache-Ereignisses.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* wenn `action` das Bit "change event rank to symptom" enthält|
|message|string|Text der Nachricht.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* wenn `action` das Bit "add message" 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>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* wenn `action` das Bit "change severity" 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>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich* wenn `action` das Bit "suppress event" 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]: # ({9a2accef-0282adaa})
#### Unterdrücken eines Ereignisses auf unbestimmte Zeit

Unterdrücken Sie ein einzelnes Ereignis ohne Ablaufzeit.

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

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

Antwort:

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

[comment]: # ({/9a2accef-0282adaa})

[comment]: # ({dcf1d864-92dd2ab3})
#### Aufhebung der Unterdrückung eines Ereignisses

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

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

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

Antwort:

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

[comment]: # ({/dcf1d864-92dd2ab3})

[comment]: # ({b088ad43-7c63815d})
#### 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](/manual/api#performing-requests):

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

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

[comment]: # ({/b088ad43-7c63815d})

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

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

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