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

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

[comment]: # ({07725e16-eed7fdda})
### Descrição

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

Este método permite atualizar eventos. As seguintes ações de atualização podem ser realizadas:

-   Fechar evento. Se o evento já estiver resolvido, esta ação será ignorada.
-   Reconhecer evento. Se o evento já estiver reconhecido, esta ação será ignorada.
-   Desfazer reconhecimento do evento. Se o evento não estiver reconhecido, esta ação será ignorada.
-   Adicionar mensagem.
-   Alterar a severidade do evento. Se o evento já tiver a mesma severidade, esta ação será ignorada.
-   Suprimir evento. Se o evento já estiver suprimido, esta ação será ignorada.
-   Remover supressão do evento. Se o evento não estiver suprimido, esta ação será ignorada.
-   Alterar o ranking do evento para causa. Se o evento já estiver classificado como causa, esta ação será ignorada.
-   Alterar o ranking do evento para sintoma. Se o evento já estiver classificado como sintoma, esta ação será ignorada.

::: noteimportant
Apenas eventos de trigger podem ser atualizados.<br>
Apenas eventos de problema podem ser atualizados.<br>
Permissões de leitura/gravação para trigger são necessárias para fechar o evento ou alterar a severidade do evento.<br>
Para fechar um evento, o fechamento manual deve ser permitido no trigger.
:::

::: noteclassic
Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Veja [Funções de usuário](/manual/web_interface/frontend_sections/users/user_roles) para mais informações.
:::

[comment]: # ({/07725e16-eed7fdda})

[comment]: # ({813f39be-32560b88})
### Parâmetros

`(object/array)` Parâmetros contendo os IDs dos eventos e as operações de atualização que devem ser realizadas.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|eventids|ID/array|IDs dos [eventos](/manual/api/reference/event/object#event) a serem reconhecidos.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório*|
|action|integer|Ação(ões) de atualização do evento.<br><br>Valores possíveis do bitmap:<br>1 - fechar problema;<br>2 - reconhecer evento;<br>4 - adicionar mensagem;<br>8 - alterar severidade;<br>16 - remover reconhecimento do evento;<br>32 - suprimir evento;<br>64 - remover supressão do evento;<br>128 - alterar classificação do evento para causa;<br>256 - alterar classificação do evento para sintoma.<br><br>Este é um campo de máscara de bits; qualquer soma dos valores possíveis é aceitável (por exemplo, 34 para reconhecer e suprimir evento).<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório*|
|cause_eventid|ID|ID do evento causa.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se `action` contiver o bit "alterar classificação do evento para sintoma"|
|message|string|Texto da mensagem.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se `action` contiver o bit "adicionar mensagem"|
|severity|integer|Nova severidade para os eventos.<br><br>Valores possíveis:<br>0 - não classificado;<br>1 - informação;<br>2 - aviso;<br>3 - média;<br>4 - alta;<br>5 - desastre.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se `action` contiver o bit "alterar severidade"|
|suppress_until|integer|Timestamp Unix até o qual o evento deve ser suprimido.<br><br>Se definido como "0", a supressão será indefinida.<br><br>[Comportamento do parâmetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obrigatório* se `action` contiver o bit "suprimir evento"|

[comment]: # ({/813f39be-32560b88})

[comment]: # ({94f3ab84-94f3ab84})
### Valores de retorno

`(object)` Retorna um objeto contendo os IDs dos eventos atualizados
na propriedade `eventids`.

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

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

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

[comment]: # ({2aa7a118-9e923e4c})
#### Reconhecendo um evento

Reconheça um único evento e deixe uma mensagem.

[Requisição](/manual/api#performing-requests):

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

Resposta:

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

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

[comment]: # ({63d8190d-94e25d7e})
#### Alterando a gravidade do evento

Altere a gravidade de vários eventos e deixe uma mensagem.

[Requisição](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Manutenção necessária para corrigir.",
        "severity": 4
    },
    "id": 1
}
```

Resposta:

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

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

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

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

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