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

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

[comment]: # ({07725e16-eed7fdda})
### Descripción

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

Este método permite actualizar eventos. Se pueden realizar las siguientes acciones de actualización:

-   Cerrar evento. Si el evento ya está resuelto, esta acción se omitirá.
-   Reconocer evento. Si el evento ya está reconocido, esta acción se omitirá.
-   Desreconocer evento. Si el evento no está reconocido, esta acción se omitirá.
-   Añadir mensaje.
-   Cambiar la severidad del evento. Si el evento ya tiene la misma severidad, esta acción se omitirá.
-   Suprimir evento. Si el evento ya está suprimido, esta acción se omitirá.
-   Anular la supresión del evento. Si el evento no está suprimido, esta acción se omitirá.
-   Cambiar el rango del evento a causa. Si el evento ya está clasificado como causa, esta acción se omitirá.
-   Cambiar el rango del evento a síntoma. Si el evento ya está clasificado como síntoma, esta acción se omitirá.

::: noteimportant
Solo se pueden actualizar eventos de trigger.<br>
Solo se pueden actualizar eventos de problema.<br>
Se requieren permisos de lectura/escritura para el trigger para cerrar el evento o cambiar la severidad del evento.<br>
Para cerrar un evento, debe permitirse el cierre manual en el trigger.
:::

::: noteclassic
Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte [Roles de usuario](/manual/web_interface/frontend_sections/users/user_roles) para obtener más información.
:::

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

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

`(objeto/array)` Parámetros que contienen los IDs de los eventos y las operaciones de actualización que deben realizarse.

|Parámetro|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|eventids|ID/array|IDs de los [eventos](/manual/api/reference/event/object#event) a reconocer.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|
|action|integer|Acción(es) de actualización del evento.<br><br>Valores posibles de la máscara de bits:<br>1 - cerrar problema;<br>2 - reconocer evento;<br>4 - añadir mensaje;<br>8 - cambiar severidad;<br>16 - des-reconocer evento;<br>32 - suprimir evento;<br>64 - dejar de suprimir evento;<br>128 - cambiar el rango del evento a causa;<br>256 - cambiar el rango del evento a síntoma.<br><br>Este es un campo de máscara de bits; se acepta cualquier suma de los valores posibles (por ejemplo, 34 para reconocer y suprimir evento).<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|
|cause_eventid|ID|ID del evento causa.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si `action` contiene el bit "cambiar el rango del evento a síntoma"|
|message|string|Texto del mensaje.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si `action` contiene el bit "añadir mensaje"|
|severity|integer|Nueva severidad para los eventos.<br><br>Valores posibles:<br>0 - no clasificado;<br>1 - información;<br>2 - advertencia;<br>3 - media;<br>4 - alta;<br>5 - desastre.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si `action` contiene el bit "cambiar severidad"|
|suppress_until|integer|Marca de tiempo Unix hasta la que el evento debe ser suprimido.<br><br>Si se establece en "0", la supresión será indefinida.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si `action` contiene el bit "suprimir evento"|

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

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

`(object)` Devuelve un objeto que contiene los IDs de los eventos actualizados
bajo la propiedad `eventids`.

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

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

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

[comment]: # ({2aa7a118-9e923e4c})
#### Reconociendo un evento

Reconocer un solo evento y dejar un mensaje.

[Solicitud](/manual/api#performing-requests):

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

Respuesta:

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

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

[comment]: # ({63d8190d-94e25d7e})
#### Cambiar la gravedad del evento

Cambiar la gravedad de varios eventos y dejar un mensaje.

[Solicitud](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Se requiere mantenimiento para solucionarlo.",
        "severity": 4
    },
    "id": 1
}
```

Respuesta:

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

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

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

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

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