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

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

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

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

Šī metode ļauj atjaunināt notikumus. Var veikt šādas atjaunināšanas darbības:

-   Aizvērt notikumu. Ja notikums jau ir atrisināts, šī darbība tiks izlaista.
-   Apstiprināt notikumu. Ja notikums jau ir apstiprināts, šī darbība tiks izlaista.
-   Atcelt notikuma apstiprinājumu. Ja notikums nav apstiprināts, šī darbība tiks izlaista.
-   Pievienot ziņojumu.
-   Mainīt notikuma nopietnību. Ja notikumam jau ir tāda pati nopietnība, šī darbība tiks izlaista.
-   Apspiest notikumu. Ja notikums jau ir apspiests, šī darbība tiks izlaista.
-   Atcelt notikuma apspiešanu. Ja notikums nav apspiests, šī darbība tiks izlaista.
-   Mainīt notikuma rangu uz cēloni. Ja notikums jau ir klasificēts kā cēlonis, šī darbība tiks izlaista.
-   Mainīt notikuma rangu uz simptomu. Ja notikums jau ir klasificēts kā simptoms, šī darbība tiks izlaista.

::: noteimportant
Atjaunināt var tikai trigeru notikumus.<br>
Atjaunināt var tikai problēmu notikumus.<br>
Lai aizvērtu notikumu vai mainītu notikuma nopietnību, ir nepieciešamas trigerim piešķirtas lasīšanas/rakstīšanas tiesības.<br>
Lai aizvērtu notikumu, trigerī jābūt atļautai manuālai aizvēršanai.
:::

::: noteclassic
Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas
izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju
lomas](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Parametri, kas satur notikumu ID un atjaunināšanas
darbības, kas jāveic.

|Parametrs|[Type](/manual/api/reference_commentary#data-types)|Apraksts|
|--|--|------|
|eventids|ID/array|Apstiprināmo [notikumu](/manual/api/reference/event/object#event) ID.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*|
|action|integer|Notikumu atjaunināšanas darbība(-as).<br><br>Iespējamās bitkartes vērtības:<br>1 - aizvērt problēmu;<br>2 - apstiprināt notikumu;<br>4 - pievienot ziņojumu;<br>8 - mainīt svarīguma pakāpi;<br>16 - noņemt notikuma apstiprinājumu;<br>32 - apspiest notikumu;<br>64 - atcelt notikuma apspiešanu;<br>128 - mainīt notikuma rangu uz cēloni;<br>256 - mainīt notikuma rangu uz simptomu.<br><br>Šis ir bitmaskas lauks; ir pieļaujama jebkura iespējamo bitkartes vērtību summa (piemēram, 34 notikuma apstiprināšanai un apspiešanai).<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*|
|cause_eventid|ID|Cēloņa notikuma ID.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja `action` satur bitu "mainīt notikuma rangu uz simptomu"|
|message|string|Ziņojuma teksts.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja `action` satur bitu "pievienot ziņojumu"|
|severity|integer|Jaunā notikumu svarīguma pakāpe.<br><br>Iespējamās vērtības:<br>0 - nav klasificēts;<br>1 - informācija;<br>2 - brīdinājums;<br>3 - vidējs;<br>4 - augsts;<br>5 - katastrofa.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja `action` satur bitu "mainīt svarīguma pakāpi"|
|suppress_until|integer|Unix laikspiedols, līdz kuram notikums ir jāapslāpē.<br><br>Ja iestatīts uz "0", apspiešana būs bez termiņa.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja `action` satur bitu "apspiest notikumu"|

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

[comment]: # ({2974bd26-94f3ab84})
### Atgrieztās vērtības

`(object)` Atgriež objektu, kas satur atjaunināto notikumu ID īpašībā `eventids`.

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

[comment]: # ({b41637d2-b41637d2})
### Piemēri

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

[comment]: # ({2aa7a118-9e923e4c})
#### Notikuma apstiprināšana

Apstipriniet vienu notikumu un atstājiet ziņojumu.

[Pieprasījums](/manual/api#performing-requests):

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

Atbilde:

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

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

[comment]: # ({63d8190d-94e25d7e})
#### Notikuma nopietnības maiņa

Mainiet vairāku notikumu nopietnību un atstājiet ziņojumu.

[Pieprasījums](/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
}
```

Atbilde:

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

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

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

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

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