[comment]: # aside:1

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

Els següents objectes són relacionats amb l'API `alert`.

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

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

::: noteclassic
Les alertes es creen pel servidor de Zabbix i no es poden modificar per mitjà de l'API.
:::

L'objecte alerta conté informació sobre en quines condicions certes accions s'han executat correctament. Té les propietats següents:

|Propietat|[Tipus](/manual/api/reference_commentary#data-types)|Descripció|
|--|--|------|
|alertid|ID|ID de l'alerta.|
|actionid|ID|ID de l'acció que ja generat l'alerta.|
|alerttype|integer|Tipus d'alerta.<br><br>Valors possibles:<br>0 - missatge;<br>1 - comanda remota.|
|clock|timestamp|Moment en que es va generar l'alerta.|
|error|string|text d'error si hi ha problemes enviant un missatge o executant una comanda.|
|esc\_step|integer|Passa d'escalada de l'acció on es va generar l'alerta.|
|eventid|string|ID de l'esdeveniment que ha disparat el trigger de l'acció.|
|mediatypeid|string|ID del tipus de mitjà que s'ha emprat per enviar el missatge.|
|message|text|Missatge de text.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `alerttype` s'estableix a "missatge"|
|retries|integer|Nombre de vegades que el Zabbix ha provat d'enviar el missatge.|
|sendto|string|Adreça, nom d'usuari o algun altre identificador del destinatari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `alerttype` s'estableix a "missatge"|
|status|integer|Estat que indica si l'operació d'acció s'ha executat correctament..<br><br>Els valors possibles dels missatges d'alerta són:<br>0 - missatge no enviat.<br>1 - missatge enviat.<br>2 - ha fallat després de provar-ho diversos cops.<br>3 - la nova alerta encara no ha estat processada pel gestor d'alertes.<br><br>Valors possibles per les comandes d'alertes:<br>0 - comanda no executada.<br>1 - comanda executada.<br>2 - s'ha provat d'executar la comanda a l'agent de Zabbix, però aquest no era pas disponible.|
|subject|string|Assumpte del missatge. <br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `alerttype` s'estableix a "missatge"|
|userid|string|ID de l'usuari on s'ha enviat el missatge.|
|p\_eventid|string|ID de l'esdeveniment del problema, qui ha generat l'alerta.|
|acknowledgeid|string|ID de reconeixement, qui ha generat l'alerta.|

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