[comment]: # translation:outdated

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

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

[comment]: # ({96ece3aa-eed7fdda})
### Descripción

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

Este método permite actualizar eventos. Las siguientes acciones de actualización pueden ser
realizadas:

- Cerrar evento. Si el evento ya está resuelto, esta acción será
    omitida.
- Reconocer evento. Si el evento ya ha sido reconocido, esta acción
    será omitida.
- Evento sin reconocimiento. Si no se reconoce el evento, se omitirá esta acción.
-   Agregar mensaje.
- Cambiar la gravedad del evento. Si el evento ya tiene la misma gravedad,
    se omitirá la acción.
- Suprimir evento. Si el evento ya está suprimido, se omitirá esta acción.
- Desactivar evento. Si el evento no está suprimido, esta acción se omitirá.

::: noteimportant
Sólo se pueden actualizar los eventos de iniciador.\
Sólo se pueden actualizar los eventos de problemas.\
Se requieren derechos de lectura/escritura para el iniciador para cerrar el evento o para
cambiar la gravedad del evento.\
Para cerrar un evento, se debe permitir el cierre manual en el
iniciador.
:::

::: noteclassic
Este método está disponible para usuarios de cualquier tipo. Los permisos
para llamar al método se pueden revocar en la configuración de roles de usuario. Ver [Roles de
usuario](/manual/web_interface/frontend_sections/users/user_roles)
para más información.
:::

[comment]: # ({/96ece3aa-eed7fdda})

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

`(objeto/matriz)` Parámetros que contienen los ID de los eventos y las operaciones de actualización
 que se deben realizar.

|Parámetro|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|eventids|ID/matriz|ID de los [eventos](/manual/api/reference/event/object#event) a reconocer.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter- comportamiento):<br>- *obligatorio*|
|action|entero|Acciones de actualización de evento.<br>Este es un campo de máscara de bits, cualquier combinación de posibles valores de mapa de bits es aceptable.<br><br>Posibles valores de mapa de bits:<br>1 - cerrar problema;<br >2 - reconocer evento;<br>4 - agregar mensaje;<br>8 - cambiar gravedad;<br>16 - cancelar evento;<br>32 - suprimir evento;<br>64 - cancelar evento;<br>128 - cambiar el rango del evento a causa;<br>256 - cambiar el rango del evento a síntoma.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|
|cause_eventid|ID|ID del evento de causa.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si `acción` contiene "cambiar el rango del evento a bit de síntoma"|
|message|cadena|Texto del mensaje.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si `acción` contiene "agregar mensaje" poco |
|severity|entero|Nueva gravedad para eventos.<br><br>Valores posibles:<br>0 - no clasificado;<br>1 - información;<br>2 - advertencia;<br>3 - promedio;<br >4 - alto;<br>5 - desastre.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si `acción` contiene el "cambio bit de gravedad"|
|suppress_until|entero|Marca de tiempo de Unix hasta la cual se debe suprimir el evento.<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 `acción` contiene el bit "suprimir evento"|

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

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

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

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

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

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

[comment]: # ({2aa7a118-9e923e4c})
#### Reconocer 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": "Problem resolved."
    },
    "id": 1
}
```

Respuesta:

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

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

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

Cambie la gravedad de varios eventos y deje un mensaje.

[Solicitud](/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
}
```

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})