[comment]: # translation:outdated

[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ń powagę zdarzenia.
Jeśli zdarzenie ma już taką samą powagę, ta akcja zostanie pominięta.
-   Wycisz zdarzenie.
Jeśli zdarzenie jest już wyciszone, ta akcja zostanie pominięta.
-   Cofnij wyciszenie zdarzenia.
Jeśli zdarzenie nie jest wyciszone, ta akcja zostanie pominięta.
-   Zmień rangę zdarzenia na przyczynę.
Jeśli zdarzenie ma już rangę przyczyny, ta akcja zostanie pominięta.
-   Zmień rangę zdarzenia na objaw.
Jeśli zdarzenie ma już rangę objawu, 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 powagi 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 mają zostać wykonane.

|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>Dostępne wartości bitmapy:<br>1 - zamknij problem;<br>2 - potwierdź zdarzenie;<br>4 - dodaj wiadomość;<br>8 - zmień ważność;<br>16 - cofnij potwierdzenie zdarzenia;<br>32 - wstrzymaj zdarzenie;<br>64 - wznow wstrzymanie zdarzenia;<br>128 - zmień rangę zdarzenia na przyczynę;<br>256 - zmień rangę zdarzenia na objaw.<br><br>To pole jest maską bitową; dopuszczalna jest dowolna suma możliwych wartości bitmapy (na przykład 34 dla potwierdzenia i wstrzymania zdarzenia).<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|cause_eventid|ID|ID zdarzenia będącego przyczyną.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *required* jeśli `action` zawiera bit "change event rank to symptom"|
|message|string|Treść wiadomości.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *required* jeśli `action` zawiera bit "add message"|
|severity|integer|Nowa ważność zdarzeń.<br><br>Dostępne wartości:<br>0 - nie sklasyfikowano;<br>1 - informacja;<br>2 - ostrzeżenie;<br>3 - przeciętna;<br>4 - wysoka;<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ć wstrzymane.<br><br>Jeśli ustawiono na "0", wstrzymanie 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]: # ({9a2accef-0282adaa})
#### Wyciszanie zdarzenia bezterminowo

Wycisz pojedyncze zdarzenie bez czasu wygaśnięcia.

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

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

Odpowiedź:

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

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

[comment]: # ({dcf1d864-92dd2ab3})
#### Cofnięcie wyciszenia zdarzenia

Cofnij wyciszenie pojedynczego wcześniej wyciszonego zdarzenia.

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

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

Odpowiedź:

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

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

[comment]: # ({b088ad43-7c63815d})
#### Potwierdź i wycisz zdarzenie

Potwierdź jedno lub więcej zdarzeń, dodaj wiadomość i wycisz je w tym samym żądaniu.

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

```json
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": [
            "20427",
            "20428"
        ],
        "action": 38,
        "message": "Suppressing during planned maintenance.",
        "suppress_until": 0
    },
    "id": 1
}
```

Odpowiedź:

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

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

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

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

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