[comment]: # aside: 1

[comment]: # ({195463c3-8bbba5df})
# Objet déclencheur

Les objets suivants sont directement liés à l’API `trigger`.

[comment]: # ({/195463c3-8bbba5df})

[comment]: # ({44461ee2-db828bca})
### Déclencheur

L'objet déclencheur possède les propriétés suivantes.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|triggerid|ID|ID du déclencheur.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*<br>- *obligatoire* pour les opérations de mise à jour|
|description|string|Nom du déclencheur.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* pour les opérations de création|
|expression|string|Expression du déclencheur.<br><br>Les éléments dont `value_type` est défini sur `5` (binaire) ne peuvent pas être utilisés dans les expressions de déclencheur.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* pour les opérations de création|
|event\_name|string|Nom de l'événement généré par le déclencheur.|
|opdata|string|Données opérationnelles.|
|comments|string|Description supplémentaire du déclencheur.|
|error|string|Texte d'erreur s'il y a eu des problèmes lors de la mise à jour de l'état du déclencheur.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|flags|integer|[Origine](/manual/api/reference_commentary#entity-origin-flags) du déclencheur.<br><br>Valeurs possibles :<br>0 - *(par défaut)* un déclencheur simple ;<br>4 - un déclencheur converti depuis un prototype.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|lastchange|timestamp|Moment où le déclencheur a changé d'état pour la dernière fois.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|priority|integer|Niveau de gravité du déclencheur.<br><br>Valeurs possibles :<br>0 - *(par défaut)* non classé ;<br>1 - information ;<br>2 - avertissement ;<br>3 - moyen ;<br>4 - élevé ;<br>5 - catastrophe.|
|state|integer|État du déclencheur.<br><br>Valeurs possibles :<br>0 - *(par défaut)* l'état du déclencheur est à jour ;<br>1 - l'état actuel du déclencheur est inconnu.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|status|integer|Indique si le déclencheur est activé ou désactivé.<br><br>Valeurs possibles :<br>0 - *(par défaut)* activé ;<br>1 - désactivé.|
|templateid|ID|ID du déclencheur du modèle parent.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|type|integer|Indique si le déclencheur peut générer plusieurs événements de problème.<br><br>Valeurs possibles :<br>0 - *(par défaut)* ne pas générer plusieurs événements ;<br>1 - générer plusieurs événements.|
|url|string|URL associée au déclencheur.|
|url_name|string|Libellé de l'URL associée au déclencheur.|
|value|integer|Indique si le déclencheur est dans l'état OK ou problème.<br><br>Valeurs possibles :<br>0 - *(par défaut)* OK ;<br>1 - problème.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|recovery\_mode|integer|Mode de génération de l'événement OK.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Expression ;<br>1 - Expression de rétablissement ;<br>2 - Aucun.|
|recovery\_expression|string|Expression de rétablissement du déclencheur.<br><br>Les éléments dont `value_type` est défini sur `5` (binaire) ne peuvent pas être utilisés dans les expressions de rétablissement du déclencheur.|
|correlation\_mode|integer|Fermeture de l'événement OK.<br><br>Valeurs possibles :<br>0 - *(par défaut)* tous les problèmes ;<br>1 - tous les problèmes si les valeurs des tags correspondent.|
|correlation\_tag|string|Tag de correspondance.|
|manual\_close|integer|Autoriser la fermeture manuelle.<br><br>Valeurs possibles :<br>0 - *(par défaut)* non ;<br>1 - oui.|
|uuid|string|Identifiant unique universel, utilisé pour lier les déclencheurs importés à ceux déjà existants. Généré automatiquement s'il n'est pas fourni.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si le déclencheur appartient à un modèle|

[comment]: # ({/44461ee2-db828bca})

[comment]: # ({5a130da9-0188f389})
### Balise de déclencheur

L'objet balise de déclencheur possède les propriétés suivantes.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nom de la balise de déclencheur.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Valeur de la balise de déclencheur.|

[comment]: # ({/5a130da9-0188f389})