[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({6f7a4854-05585755})
# Objet d'alerte

Les objets suivants sont directement liés à l'API `alert`.

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

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

::: noteclassic
Les alertes sont créées par le serveur Zabbix et ne peuvent pas être modifiées via l'API.
:::

L'objet alerte contient des informations indiquant si certaines opérations
d'action ont été exécutées avec succès. Il possède les
propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|alertid|ID|ID de l'alerte.|
|actionid|ID|ID de l'action qui a généré l'alerte.|
|alerttype|integer|Type d'alerte.<br><br>Valeurs possibles :<br>0 - message ;<br>1 - commande distante.|
|clock|timestamp|Heure à laquelle l'alerte a été générée.|
|error|string|Texte d'erreur en cas de problème lors de l'envoi d'un message ou de l'exécution d'une commande.|
|esc\_step|integer|Étape d'escalade de l'action pendant laquelle l'alerte a été générée.|
|eventid|ID|ID de l'événement qui a déclenché l'action.|
|mediatypeid|ID|ID du type de média utilisé pour envoyer le message.|
|message|text|Texte du message.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *pris en charge* si `alerttype` est défini sur "message"|
|retries|integer|Nombre de fois que Zabbix a tenté d'envoyer le message.|
|sendto|string|Adresse, nom d'utilisateur ou autre identifiant du destinataire.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *pris en charge* si `alerttype` est défini sur "message"|
|status|integer|Statut indiquant si l'opération d'action a été exécutée avec succès.<br><br>Valeurs possibles si `alerttype` est défini sur "message" :<br>0 - message non envoyé ;<br>1 - message envoyé ;<br>2 - échec après plusieurs tentatives ;<br>3 - la nouvelle alerte n'est pas encore traitée par le gestionnaire d'alertes.<br><br>Valeurs possibles si `alerttype` est défini sur "remote command" :<br>0 - commande non exécutée ;<br>1 - commande exécutée ;<br>2 - tentative d'exécution de la commande sur le Zabbix agent, mais celui-ci n'était pas disponible.|
|subject|string|Sujet du message.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *pris en charge* si `alerttype` est défini sur "message"|
|userid|ID|ID de l'utilisateur auquel le message a été envoyé.|
|p\_eventid|ID|ID de l'événement de problème qui a généré l'alerte.|
|acknowledgeid|ID|ID de l'accusé de réception qui a généré l'alerte.|

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