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

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

[comment]: # ({2224f5b5-eed7fdda})
### Описание

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

Этот метод позволяет обновлять события.
Можно выполнить следующие действия обновления:

-   Закрыть событие.
Если событие уже разрешено, это действие будет пропущено.
-   Подтвердить событие.
Если событие уже подтверждено, это действие будет пропущено.
-   Снять подтверждение с события.
Если событие не подтверждено, это действие будет пропущено.
-   Добавить сообщение.
-   Изменить серьезность события.
Если у события уже такая же серьезность, это действие будет пропущено.
-   Подавить событие.
Если событие уже подавлено, это действие будет пропущено.
-   Снять подавление с события.
Если событие не подавлено, это действие будет пропущено.
-   Изменить ранг события на cause.
Если событие уже имеет ранг cause, это действие будет пропущено.
-   Изменить ранг события на symptom.
Если событие уже имеет ранг symptom, это действие будет пропущено.

::: noteimportant
Можно обновлять только события триггера.<br>
Можно обновлять только проблемные события.<br>
Для закрытия события или изменения его серьезности требуются права чтения/записи для триггера.<br>
Чтобы закрыть событие, в триггере должно быть разрешено ручное закрытие.
:::

::: noteclassic
Этот метод доступен пользователям любого типа.
Разрешения на вызов метода могут быть отозваны в настройках роли пользователя.
Дополнительные сведения см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

[comment]: # ({2559b8ef-32560b88})
### Параметры

`(object/array)` Параметры, содержащие IDs событий и операций обновления, которые должны быть выполнены.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|eventids|ID/array|IDs [событий](/manual/api/reference/event/object#event), которые нужно подтвердить.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|action|integer|Действие(я) обновления события.<br><br>Возможные значения битовой карты:<br>1 - закрыть проблему;<br>2 - подтвердить событие;<br>4 - добавить сообщение;<br>8 - изменить серьезность;<br>16 - снять подтверждение события;<br>32 - подавить событие;<br>64 - отменить подавление события;<br>128 - изменить ранг события на cause;<br>256 - изменить ранг события на symptom.<br><br>Это поле битовой маски; допустима любая сумма возможных значений битовой карты (например, 34 для подтверждения и подавления события).<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
|cause_eventid|ID|ID cause-события.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required* если `action` содержит бит "change event rank to symptom"|
|message|string|Текст сообщения.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required* если `action` содержит бит "add message"|
|severity|integer|Новая серьезность для событий.<br><br>Возможные значения:<br>0 - not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required* если `action` содержит бит "change severity"|
|suppress_until|integer|Unix timestamp, до которого событие должно быть подавлено.<br><br>Если установлено значение "0", подавление будет бессрочным.<br><br>[Поведение параметра](/manual/api/reference_commentary#parameter-behavior):<br>- *required* если `action` содержит бит "suppress event"|

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

[comment]: # ({2974bd26-94f3ab84})
### Возвращаемые значения

`(object)` Возвращает объект, содержащий идентификаторы обновленных событий в свойстве `eventids`.

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

[comment]: # ({b41637d2-b41637d2})
### Примеры

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

[comment]: # ({2aa7a118-9e923e4c})
#### Подтверждение события

Подтвердите одно событие и оставьте сообщение.

[Запрос](/manual/api#performing-requests):

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

Ответ:

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

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

[comment]: # ({63d8190d-94e25d7e})
#### Изменение серьезности события

Измените серьезность для нескольких событий и оставьте сообщение.

[Запрос](/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
}
```

Ответ:

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

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

[comment]: # ({aadd99f7-aadd99f7})
### Источник

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

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