[comment]: # translation:outdated

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

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

[comment]: # ({3cf9db19-eed7fdda})
### Beschrijving

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

Met deze methode kunnen gebeurtenissen worden bijgewerkt. De volgende update-acties kunnen:
uitgevoerd:

- Sluit evenement. Als de gebeurtenis al is opgelost, is deze actie:
    overgeslagen.
- Erken gebeurtenis. Als de gebeurtenis al is bevestigd, deze actie
    zal worden overgeslagen.
- Unacknowledge event. Als de gebeurtenis niet wordt bevestigd, wordt deze actie overgeslagen.
-   Bericht toevoegen.
- De ernst van de gebeurtenis wijzigen. Als de gebeurtenis al dezelfde ernst heeft, is dit:
    actie wordt overgeslagen.

::: noteimportant
Alleen trigger gebeurtenissen kunnen worden bijgewerkt.\
Alleen probleemgebeurtenissen kunnen worden bijgewerkt.\
Lees-/schrijfrechten voor trigger zijn vereist om de gebeurtenis te sluiten of om
de ernst van de gebeurtenis wijzigen.\
Om een evenement te sluiten, moet handmatig sluiten zijn toegestaan in de
trekker.
:::

::: noteclassic
Deze methode is beschikbaar voor gebruikers van elk type. Rechten
om de methode aan te roepen, kan worden ingetrokken in de instellingen van de gebruikersrol. Zie [Gebruiker
rollen](/manual/web_interface/frontend_sections/administration/user_roles)
voor meer informatie.
:::

[comment]: # ({/3cf9db19-eed7fdda})

[comment]: # ({4f7f6cc3-32560b88})
### Parameters

`(object/array)` Parameters met de ID's van de gebeurtenissen en update
handelingen die moeten worden uitgevoerd.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|**gebeurtenissen**<br>(verplicht)|string/object|ID's van de te bevestigen gebeurtenissen.|
|**actie**<br>(vereist)|geheel getal|Actie(s) voor het bijwerken van gebeurtenissen. Dit is een bitmaskerveld, elke combinatie van waarden is acceptabel.<br><br>Mogelijke waarden:<br>1 - probleem sluiten;<br>2 - gebeurtenis bevestigen;<br>4 - bericht toevoegen;<br>8 - de ernst wijzigen;<br>16 - gebeurtenis ongedaan maken.|
|message|string|Tekst van het bericht.<br>**Vereist**, als actie de vlag 'bericht toevoegen' bevat.|
|severity|integer|Nieuwe ernst voor gebeurtenissen.<br>**Vereist**, als actie de vlag 'ernst wijzigen' bevat.<br><br>Mogelijke waarden:<br>0 - niet geclassificeerd;<br>1 - informatie;<br>2 - waarschuwing;<br>3 - gemiddeld;<br>4 - hoog;<br>5 - ramp.|

[comment]: # ({/4f7f6cc3-32560b88})

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

`(object)` Retourneert een object dat de ID's van de bijgewerkte gebeurtenissen bevat
onder de eigenschap 'eventids'.

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

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

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

[comment]: # ({2a20eeea-9e923e4c})
#### Erkenning van een evenement

Erken een enkele gebeurtenis en laat een bericht achter.

Verzoek:


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

Antwoord:

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

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

[comment]: # ({7d16988e-94e25d7e})
#### De ernst van de gebeurtenis wijzigen

Wijzig de ernst voor meerdere gebeurtenissen en laat een bericht achter.

Verzoek:

```json
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Maintenance required to fix it.",
        "severity": 4
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Antwoord:

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

[comment]: # ({/7d16988e-94e25d7e})

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

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

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