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

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

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

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

Ta metoda umożliwia aktualizację zdarzeń.
Można wykonać następujące akcje aktualizacji:

-   Zamknij zdarzenie.
Jeśli zdarzenie jest już rozwiązane, ta akcja zostanie pominięta.
-   Potwierdź zdarzenie.
Jeśli zdarzenie jest już potwierdzone, ta akcja zostanie pominięta.
-   Cofnij potwierdzenie zdarzenia.
Jeśli zdarzenie nie jest potwierdzone, ta akcja zostanie pominięta.
-   Dodaj wiadomość.
-   Zmień poziom ważności zdarzenia.
Jeśli zdarzenie ma już ten sam poziom ważności, ta akcja zostanie pominięta.
-   Wycisz zdarzenie.
Jeśli zdarzenie jest już wyciszone, ta akcja zostanie pominięta.
-   Przywróć wyciszenie zdarzenia.
Jeśli zdarzenie nie jest wyciszone, ta akcja zostanie pominięta.
-   Zmień rangę zdarzenia na przyczynę.
Jeśli zdarzenie jest już oznaczone jako przyczyna, ta akcja zostanie pominięta.
-   Zmień rangę zdarzenia na objaw.
Jeśli zdarzenie jest już oznaczone jako objaw, ta akcja zostanie pominięta.

::: noteimportant
Można aktualizować tylko zdarzenia wyzwalaczy.<br>
Można aktualizować tylko zdarzenia problemów.<br>
Do zamknięcia zdarzenia lub zmiany jego poziomu ważności wymagane są uprawnienia odczytu/zapisu dla wyzwalacza.<br>
Aby zamknąć zdarzenie, w wyzwalaczu musi być dozwolone ręczne zamknięcie.
:::

::: noteclassic
Ta metoda jest dostępna dla użytkowników dowolnego typu.
Uprawnienia do wywołania metody można odebrać w ustawieniach roli użytkownika.
Więcej informacji można znaleźć w sekcji [Role użytkowników](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Parametry zawierające identyfikatory zdarzeń oraz operacji aktualizacji, które należy wykonać.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|eventids|ID/array|Identyfikatory [zdarzeń](/manual/api/reference/event/object#event), które mają zostać potwierdzone.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|action|integer|Akcja(-e) aktualizacji zdarzenia.<br><br>Możliwe wartości bitowe:<br>1 - zamknij problem;<br>2 - potwierdź zdarzenie;<br>4 - dodaj wiadomość;<br>8 - zmień powagę;<br>16 - cofnij potwierdzenie zdarzenia;<br>32 - wycisz zdarzenie;<br>64 - wyłącz wyciszenie zdarzenia;<br>128 - zmień rangę zdarzenia na przyczynę;<br>256 - zmień rangę zdarzenia na objaw.<br><br>To pole jest polem bitmaski; dopuszczalna jest dowolna suma możliwych wartości bitowych (na przykład 34 dla potwierdzenia i wyciszenia zdarzenia).<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|cause_eventid|ID|ID zdarzenia przyczyny.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *required* jeśli `action` zawiera bit "change event rank to symptom"|
|message|string|Tekst wiadomości.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *required* jeśli `action` zawiera bit "add message"|
|severity|integer|Nowa powaga zdarzeń.<br><br>Możliwe wartości:<br>0 - nie sklasyfikowano;<br>1 - informacja;<br>2 - ostrzeżenie;<br>3 - przeciętne;<br>4 - wysokie;<br>5 - katastrofa.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *required* jeśli `action` zawiera bit "change severity"|
|suppress_until|integer|Znacznik czasu Unix, do którego zdarzenie musi być wyciszone.<br><br>Jeśli ustawione na "0", wyciszenie będzie bezterminowe.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *required* jeśli `action` zawiera bit "suppress event"|

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

[comment]: # ({2974bd26-94f3ab84})
### Zwracane wartości

`(object)` Zwraca obiekt zawierający identyfikatory zaktualizowanych zdarzeń w właściwości `eventids`.

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

[comment]: # ({b41637d2-b41637d2})
### Przykłady

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

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

Potwierdź pojedyncze zdarzenie i pozostaw wiadomość.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({63d8190d-94e25d7e})
#### Zmiana ważności zdarzenia

Zmień ważność wielu zdarzeń i pozostaw wiadomość.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({aadd99f7-aadd99f7})
### Źródło

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

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