[comment]: # aside: 1

[comment]: # ({6f7a4854-05585755})
# Objeto de alerta

Los siguientes objetos están directamente relacionados con la API de `alerta`.

[comment]: # ({/6f7a4854-05585755})

[comment]: # ({c99eb067-933fed24})
### Alerta

::: noteclassic
Las alertas son creadas por el servidor Zabbix y no pueden modificarse a través de la API.
:::

El objeto de alerta contiene información sobre si ciertas operaciones de acción se han ejecutado correctamente. Tiene las siguientes propiedades.

|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|alertid|ID|ID de la alerta.|
|actionid|ID|ID de la acción que generó la alerta.|
|alerttype|integer|Tipo de alerta.<br><br>Valores posibles:<br>0 - mensaje;<br>1 - comando remoto.|
|clock|timestamp|Hora en la que se generó la alerta.|
|error|string|Texto de error si hay problemas al enviar un mensaje o ejecutar un comando.|
|esc\_step|integer|Paso de escalado de la acción durante el cual se generó la alerta.|
|eventid|ID|ID del evento que activó la acción.|
|mediatypeid|ID|ID del tipo de medio que se utilizó para enviar el mensaje.|
|message|text|Texto del mensaje.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *soportado* si `alerttype` está establecido en "mensaje"|
|retries|integer|Número de veces que Zabbix intentó enviar el mensaje.|
|sendto|string|Dirección, nombre de usuario u otro identificador del destinatario.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *soportado* si `alerttype` está establecido en "mensaje"|
|status|integer|Estado que indica si la operación de acción se ha ejecutado correctamente.<br><br>Valores posibles si `alerttype` está establecido en "mensaje":<br>0 - mensaje no enviado;<br>1 - mensaje enviado;<br>2 - falló después de varios intentos;<br>3 - la nueva alerta aún no ha sido procesada por el gestor de alertas.<br><br>Valores posibles si `alerttype` está establecido en "comando remoto":<br>0 - comando no ejecutado;<br>1 - comando ejecutado;<br>2 - se intentó ejecutar el comando en el agent de Zabbix, pero no estaba disponible.|
|subject|string|Asunto del mensaje.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *soportado* si `alerttype` está establecido en "mensaje"|
|userid|ID|ID del usuario al que se envió el mensaje.|
|p\_eventid|ID|ID del evento de problema que generó la alerta.|
|acknowledgeid|ID|ID del reconocimiento que generó la alerta.|

[comment]: # ({/c99eb067-933fed24})