[comment]: # aside: 1

[comment]: # ({3bf923db-c5a9e121})
# Objet de règle LLD

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

[comment]: # ({/3bf923db-c5a9e121})

[comment]: # ({0268e8c8-c17fa830})
### Règle LLD

L'objet de règle de découverte de bas niveau possède les propriétés suivantes.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID de la règle LLD.<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|
|delay|string|Intervalle de mise à jour de la règle LLD.<br><br>Accepte des secondes ou une unité de temps avec suffixe (par ex. 30s, 1m, 2h, 1d) et, éventuellement, un ou plusieurs [intervalles personnalisés](/manual/config/items/item/custom_intervals), le tout séparé par des points-virgules. Les intervalles personnalisés peuvent combiner des intervalles flexibles et des intervalles de planification.<br><br>Accepte les macros utilisateur. Si elles sont utilisées, la valeur doit être une seule macro. Les macros multiples ou les macros mélangées à du texte ne sont pas prises en charge. Les intervalles flexibles peuvent être écrits sous forme de deux macros séparées par une barre oblique (par ex. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Exemple :<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), ou si `type` est défini sur "Zabbix agent (active)" (7) et que `key_` ne contient pas "mqtt.get"|
|hostid|ID|ID de l'hôte auquel appartient la règle LLD.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *obligatoire* pour les opérations de création|
|interfaceid|ID|ID de l'interface de l'hôte de la règle LLD.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si la règle LLD appartient à un hôte et que `type` est défini sur "Zabbix agent", "IPMI agent", "JMX agent" ou "SNMP agent"<br>- *pris en charge* si la règle LLD appartient à un hôte et que `type` est défini sur "Simple check", "External check", "SSH agent", "TELNET agent" ou "HTTP agent"|
|key\_|string|Clé de la règle LLD.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* pour les opérations de création<br>- *lecture seule* pour les objets hérités|
|name|string|Nom de la règle LLD.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* pour les opérations de création<br>- *lecture seule* pour les objets hérités|
|type|integer|Type de la règle LLD.<br><br>Valeurs possibles :<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - Simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>16 - JMX agent;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script;<br>22 - Browser.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* pour les opérations de création<br>- *lecture seule* pour les objets hérités|
|url|string|Chaîne d'URL.<br>Prend en charge les macros utilisateur, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|allow\_traps|integer|Autoriser le remplissage de la valeur de la même manière que pour l'élément trapper.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Ne pas autoriser l'acceptation des données entrantes;<br>1 - Autoriser l'acceptation des données entrantes.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"|
|authtype|integer|Méthode d'authentification.<br><br>Valeurs possibles si `type` est défini sur "SSH agent" :<br>0 - *(par défaut)* mot de passe;<br>1 - clé publique.<br><br>Valeurs possibles si `type` est défini sur "HTTP agent" :<br>0 - *(par défaut)* aucune;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "SSH agent" ou "HTTP agent"<br>- *lecture seule* pour les objets hérités (si `type` est défini sur "HTTP agent")|
|description|string|Description de la règle LLD.|
|error|string|Texte d'erreur en cas de problème lors de la mise à jour de la valeur de la règle LLD.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|follow\_redirects|integer|Suivre les redirections de réponse lors de la collecte des données.<br><br>Valeurs possibles :<br>0 - Ne pas suivre les redirections;<br>1 - *(par défaut)* Suivre les redirections.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|headers|array|Tableau de [en-têtes](#http-header) qui seront envoyés lors de l'exécution d'une requête HTTP.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|http\_proxy|string|Chaîne de connexion du proxy HTTP(S).<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|ipmi\_sensor|string|Capteur IPMI.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "IPMI agent" et que `key_` n'est pas défini sur "ipmi.get"<br>- *pris en charge* si `type` est défini sur "IPMI agent"<br>- *lecture seule* pour les objets hérités|
|jmx\_endpoint|string|Chaîne de connexion personnalisée de l'agent JMX.<br><br>Par défaut : service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "JMX agent"|
|lifetime|string|Période après laquelle les éléments qui ne sont plus découverts seront supprimés. Accepte des secondes, une unité de temps avec suffixe ou une macro utilisateur.<br><br>Par défaut : `7d`.|
|lifetime\_type|integer|Scénario de suppression des ressources LLD perdues.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Supprimer lorsque le seuil de durée de vie est atteint;<br>1 - Ne pas supprimer;<br>2 - Supprimer immédiatement.|
|enabled\_lifetime|string|Période après laquelle les éléments qui ne sont plus découverts seront désactivés. Accepte des secondes, une unité de temps avec suffixe ou une macro utilisateur.<br><br>Par défaut : `0`.|
|enabled\_lifetime\_type|integer|Scénario de désactivation des ressources LLD perdues.<br><br>Valeurs possibles :<br>0 - Désactiver lorsque le seuil de durée de vie est atteint;<br>1 - Ne pas désactiver;<br>2 - *(par défaut)* Désactiver immédiatement.|
|master\_itemid|ID|ID de l'élément maître.<br>La récursion jusqu'à 3 éléments dépendants et un nombre maximal d'éléments dépendants égal à 999 sont autorisés.<br>La règle de découverte ne peut pas être l'élément maître d'une autre règle de découverte.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "Dependent item"<br>- *lecture seule* pour les objets hérités|
|output\_format|integer|Indique si la réponse doit être convertie en JSON.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Stocker les données brutes;<br>1 - Convertir en JSON.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|params|string|Paramètres supplémentaires selon le type de la règle LLD :<br>- script exécuté pour les règles LLD SSH et Telnet;<br>- requête SQL pour les règles LLD de surveillance de base de données;<br>- formule pour les règles LLD calculées;<br>- script pour les règles LLD de type script et navigateur.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "Database monitor", "SSH agent", "TELNET agent", "Script" ou "Browser"<br>- *lecture seule* pour les objets hérités (si `type` est défini sur "Script" ou "Browser")|
|parameters|object/array|Paramètres supplémentaires si `type` est défini sur "Script" ou "Browser".<br>Tableau d'objets avec les propriétés `name` et `value`, où `name` doit être unique.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "Script" ou "Browser"<br>- *lecture seule* pour les objets hérités|
|password|string|Mot de passe pour l'authentification.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "JMX agent" et que `username` est défini<br>- *pris en charge* si `type` est défini sur "Simple check", "Database monitor", "SSH agent", "TELNET agent" ou "HTTP agent"<br>- *lecture seule* pour les objets hérités (si `type` est défini sur "HTTP agent")|
|post\_type|integer|Type du corps des données POST stocké dans la propriété `posts`.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Données brutes;<br>2 - Données JSON;<br>3 - Données XML.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|posts|string|Données du corps de la requête HTTP(S).<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "HTTP agent" et que `post_type` est défini sur "Données JSON" ou "Données XML"<br>- *pris en charge* si `type` est défini sur "HTTP agent" et que `post_type` est défini sur "Données brutes"<br>- *lecture seule* pour les objets hérités|
|privatekey|string|Nom du fichier de clé privée.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "SSH agent" et que `authtype` est défini sur "clé publique"|
|publickey|string|Nom du fichier de clé publique.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "SSH agent" et que `authtype` est défini sur "clé publique"|
|query\_fields|array|Tableau de [champs de requête](#http-query-field) qui seront envoyés lors de l'exécution d'une requête HTTP.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|request\_method|integer|Type de méthode de requête.<br><br>Valeurs possibles :<br>0 - *(par défaut)* GET;<br>1 - POST;<br>2 - PUT;<br>3 - HEAD.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|retrieve\_mode|integer|Quelle partie de la réponse doit être stockée.<br><br>Valeurs possibles si `request_method` est défini sur "GET", "POST" ou "PUT" :<br>0 - *(par défaut)* Corps;<br>1 - En-têtes;<br>2 - Le corps et les en-têtes seront tous deux stockés.<br><br>Valeurs possibles si `request_method` est défini sur "HEAD" :<br>1 - En-têtes.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|snmp\_oid|string|OID SNMP.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "SNMP agent"<br>- *lecture seule* pour les objets hérités|
|ssl\_cert\_file|string|Chemin du fichier de clé SSL publique.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|ssl\_key\_file|string|Chemin du fichier de clé SSL privée.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|ssl\_key\_password|string|Mot de passe du fichier de clé SSL.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|state|integer|État de la règle LLD.<br><br>Valeurs possibles :<br>0 - *(par défaut)* normal;<br>1 - non pris en charge.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|status|integer|Statut de la règle LLD.<br><br>Valeurs possibles :<br>0 - *(par défaut)* règle LLD activée;<br>1 - règle LLD désactivée.|
|status\_codes|string|Plages de codes de statut HTTP requis, séparées par des virgules. Prend également en charge les macros utilisateur dans une liste séparée par des virgules.<br><br>Exemple : 200,200-{$M},{$M},200-400<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|templateid|ID|ID de la règle LLD du modèle parent.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|timeout|string|Délai d'attente de la requête de collecte des données de l'élément.<br>Accepte des secondes ou une unité de temps avec suffixe (par ex. 30s, 1m). Accepte également les macros utilisateur.<br><br>Plage de valeurs possibles : 1-600s.<br><br>Par défaut : "" - utiliser les paramètres du proxy/globales.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "Zabbix agent" (0), "Simple check" (3) et que `key_` ne commence pas par "`vmware.`" ni "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) et que `snmp_oid` commence par "`walk[`" ou "`get[`", "Script" (21), "Browser" (22)<br>- *lecture seule* pour les objets hérités|
|trapper\_hosts|string|Hôtes autorisés.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "Zabbix trapper", ou si `type` est défini sur "HTTP agent" et que `allow_traps` est défini sur "Autoriser l'acceptation des données entrantes"|
|username|string|Nom d'utilisateur pour l'authentification.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `type` est défini sur "SSH agent", "TELNET agent", ou si `type` est défini sur "JMX agent" et que `password` est défini<br>- *pris en charge* si `type` est défini sur "Simple check", "Database monitor" ou "HTTP agent"<br>- *lecture seule* pour les objets hérités (si `type` est défini sur "HTTP agent")|
|uuid|string|Identifiant unique universel, utilisé pour lier les règles LLD importées à celles déjà existantes. 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 la règle LLD appartient à un modèle|
|verify\_host|integer|Indique s'il faut valider que le nom d'hôte de la connexion correspond à celui du certificat de l'hôte.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Ne pas valider;<br>1 - Valider.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|
|verify\_peer|integer|Indique s'il faut valider que le certificat de l'hôte est authentique.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Ne pas valider;<br>1 - Valider.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si `type` est défini sur "HTTP agent"<br>- *lecture seule* pour les objets hérités|

[comment]: # ({/0268e8c8-c17fa830})

[comment]: # ({ab5307fa-b531b70b})
#### En-tête HTTP

L'objet d'en-tête possède les propriétés suivantes :

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--------|---------------------------------------------------|-----------|
|name|string|Nom de l'en-tête HTTP.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *requis*|
|value|string|Valeur de l'en-tête.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *requis*|

[comment]: # ({/ab5307fa-b531b70b})

[comment]: # ({5b4177f3-ab8034d8})
#### Champ de requête HTTP

L'objet de champ de requête définit un nom et une valeur utilisés pour spécifier un paramètre d'URL.
Il possède les propriétés suivantes :

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--------|---------------------------------------------------|-----------|
|name|string|Nom du paramètre.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|
|value|string|Valeur du paramètre.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|

[comment]: # ({/5b4177f3-ab8034d8})

[comment]: # ({7bfc5ecb-b0412737})
### Filtre de règle LLD

L'objet filtre de règle LLD définit un ensemble de conditions qui peuvent être utilisées pour filtrer les objets découverts. Il possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|conditions|object/array|Ensemble de [conditions de filtre](#lld-rule-filter-condition) à utiliser pour filtrer les résultats. Les conditions seront triées dans l'ordre de leur placement dans la formule.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|evaltype|integer|[Méthode d'évaluation](/manual/discovery/low_level_discovery#filter) des conditions de filtre.<br><br>Valeurs possibles :<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Expression personnalisée.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|eval\_formula|string|Expression générée qui sera utilisée pour évaluer les conditions de filtre. L'expression contient des ID qui font référence à des conditions de filtre spécifiques via leur `formulaid`. La valeur de `eval_formula` est égale à la valeur de `formula` pour les filtres avec une expression personnalisée.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|formula|string|Expression définie par l'utilisateur à utiliser pour l'évaluation des conditions des filtres avec une expression personnalisée. L'expression doit contenir des ID qui font référence à des conditions de filtre spécifiques via leur `formulaid`. Les ID utilisés dans l'expression doivent correspondre exactement à ceux définis dans les conditions de filtre : aucune condition ne peut rester inutilisée ou omise.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `evaltype` est défini sur "custom expression"|

[comment]: # ({/7bfc5ecb-b0412737})

[comment]: # ({d0e9011a-be83ef5c})
#### Condition de filtre de règle LLD

L'objet de condition de filtre de règle LLD définit une vérification distincte à effectuer sur la valeur d'une macro LLD. Il possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|macro|string|Macro LLD sur laquelle effectuer la vérification.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Valeur à comparer.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `operator` est défini sur "matches regular expression" ou "does not match regular expression"|
|formulaid|string|ID unique arbitraire utilisé pour référencer la condition depuis une expression personnalisée. Peut contenir uniquement des lettres majuscules. L'ID doit être défini par l'utilisateur lors de la modification des conditions de filtre, mais sera généré à nouveau lors des requêtes ultérieures.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `evaltype` de l'[objet de filtre de règle LLD](#lld-rule-filter) est défini sur "custom expression"|
|operator|integer|Opérateur de condition.<br><br>Valeurs possibles :<br>8 - *(default)* correspond à une expression régulière ;<br>9 - ne correspond pas à une expression régulière ;<br>12 - existe ;<br>13 - n'existe pas.|

::: notetip
Pour mieux comprendre comment utiliser les filtres avec différents
types d'expressions, consultez les exemples sur les pages des méthodes
[discoveryrule.get](get#retrieving-filter-conditions) et
[discoveryrule.create](create#using-a-custom-expression-filter).
:::

[comment]: # ({/d0e9011a-be83ef5c})

[comment]: # ({99ea4653-4a2b52b9})
### Chemin de macro LLD

Le chemin de macro LLD possède les propriétés suivantes :

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|lld\_macro|string|Macro LLD.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|
|path|string|Sélecteur de la valeur qui sera attribuée à la macro correspondante.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|

[comment]: # ({/99ea4653-4a2b52b9})

[comment]: # ({0769e0f5-14dc55c1})
### Prétraitement de la règle LLD

L'objet de prétraitement de la règle LLD possède les propriétés suivantes.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|Le type d'option de prétraitement.<br><br>Valeurs possibles :<br>5 - Expression régulière;<br>11 - XML XPath;<br>12 - JSONPath;<br>14 - Correspond à l'expression régulière;<br>15 - Ne correspond pas à l'expression régulière;<br>16 - Vérifier l'erreur dans JSON;<br>17 - Vérifier l'erreur dans XML;<br>20 - Ignorer les valeurs inchangées avec heartbeat;<br>21 - JavaScript;<br>23 - Prometheus vers JSON;<br>24 - CSV vers JSON;<br>25 - Remplacer;<br>27 - XML vers JSON;<br>28 - Valeur de parcours SNMP;<br>29 - Parcours SNMP vers JSON;<br>30 - Valeur SNMP get.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|params|string|Paramètres supplémentaires utilisés par l'option de prétraitement. Plusieurs paramètres sont séparés par le caractère de nouvelle ligne (\\n).<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `type` est défini sur "Expression régulière" (5), "XML XPath" (11), "JSONPath" (12), "Correspond à l'expression régulière" (14), "Ne correspond pas à l'expression régulière" (15), "Vérifier l'erreur dans JSON" (16), "Vérifier l'erreur dans XML" (17), "Ignorer les valeurs inchangées avec heartbeat" (20), "JavaScript" (21), "Prometheus vers JSON" (23), "CSV vers JSON" (24), "Remplacer" (25), "Valeur de parcours SNMP" (28), "Parcours SNMP vers JSON" (29), ou "Valeur SNMP get" (30)|
|error\_handler|integer|Type d'action utilisé en cas d'échec de l'étape de prétraitement.<br><br>Valeurs possibles :<br>0 - Le message d'erreur est défini par le serveur Zabbix;<br>1 - Ignorer la valeur;<br>2 - Définir une valeur personnalisée;<br>3 - Définir un message d'erreur personnalisé.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `type` est défini sur "Expression régulière" (5), "XML XPath" (11), "JSONPath" (12), "Correspond à l'expression régulière" (14), "Ne correspond pas à l'expression régulière" (15), "Vérifier l'erreur dans JSON" (16), "Vérifier l'erreur dans XML" (17), "Prometheus vers JSON" (23), "CSV vers JSON" (24), "XML vers JSON" (27), "Valeur de parcours SNMP" (28), "Parcours SNMP vers JSON" (29), ou "Valeur SNMP get" (30)|
|error\_handler\_params|string|Paramètres du gestionnaire d'erreurs.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `error_handler` est défini sur "Définir une valeur personnalisée" ou "Définir un message d'erreur personnalisé"|

Les paramètres et gestionnaires d'erreurs suivants sont pris en charge pour chaque type de prétraitement.

|Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers|
|------------------|----|-----------|-----------|-----------|------------------------|
|5|Expression régulière|pattern^1^|output^2^|<|0, 1, 2, 3|
|11|XML XPath|path^3^|<|<|0, 1, 2, 3|
|12|JSONPath|path^3^|<|<|0, 1, 2, 3|
|14|Correspond à l'expression régulière|pattern^1^|<|<|0, 1, 2, 3|
|15|Ne correspond pas à l'expression régulière|pattern^1^|<|<|0, 1, 2, 3|
|16|Vérifier l'erreur dans JSON|path^3^|<|<|0, 1, 2, 3|
|17|Vérifier l'erreur dans XML|path^3^|<|<|0, 1, 2, 3|
|20|Ignorer les valeurs inchangées avec heartbeat|seconds^4, 5^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|23|Prometheus vers JSON|pattern^5, 6^|<|<|0, 1, 2, 3|
|24|CSV vers JSON|character^2^|character^2^|0,1|0, 1, 2, 3|
|25|Remplacer|search string^2^|replacement^2^|<|<|
|27|XML vers JSON|<|<|<|0, 1, 2, 3|
|28|Valeur de parcours SNMP|OID^2^|Format:<br>0 - Inchangé<br>1 - UTF-8 à partir de Hex-STRING<br>2 - MAC à partir de Hex-STRING<br>3 - Entier à partir de BITS|<|0, 1, 2, 3|
|29|Parcours SNMP vers JSON^7^|Field name^2^|OID prefix^2^|Format:<br>0 - Inchangé<br>1 - UTF-8 à partir de Hex-STRING<br>2 - MAC à partir de Hex-STRING<br>3 - Entier à partir de BITS|0, 1, 2, 3|
|30|Valeur SNMP get|Format:<br>1 - UTF-8 à partir de Hex-STRING<br>2 - MAC à partir de Hex-STRING<br>3 - Entier à partir de BITS|<|<|0, 1, 2, 3|

^1^ expression régulière<br>
^2^ chaîne<br>
^3^ JSONPath ou XML XPath<br>
^4^ entier positif (avec prise en charge des suffixes de temps, par exemple 30s, 1m, 2h,
1d)<br>
^5^ macro utilisateur<br>
^6^ modèle Prometheus suivant la syntaxe :
`<metric name>{<label name>="<label value>", ...} == <value>`. Chaque
composant du modèle Prometheus (nom de métrique, nom de libellé, valeur de libellé et valeur de métrique)
peut être une macro utilisateur.<br>
^7^ Prend en charge plusieurs enregistrements "Field name,OID prefix,Format" délimités par un caractère de nouvelle ligne.

[comment]: # ({/0769e0f5-14dc55c1})

[comment]: # ({f2f34ac6-2f32e5f0})
### Remplacements de règles LLD

L'objet des remplacements de règles LLD définit un ensemble de règles (filtres,
conditions et opérations) utilisées pour remplacer les propriétés de
différents objets prototype. Il possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|name|string|Nom unique du remplacement.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|step|integer|Numéro d'ordre unique du remplacement.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|stop|integer|Arrêter le traitement des remplacements suivants si correspond.<br><br>Valeurs possibles :<br>0 - *(default)* ne pas arrêter le traitement des remplacements ;<br>1 - arrêter le traitement des remplacements si le filtre correspond.|
|filter|object|Filtre de remplacement.|
|operations|object/array|Opérations de remplacement.|

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

[comment]: # ({67737988-573b52c4})
#### Filtre de remplacement de règle LLD

L'objet de filtre de remplacement de règle LLD définit un ensemble de conditions qui, si elles correspondent à l'objet découvert, appliquent le remplacement. Il possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|conditions|object/array|Ensemble de [conditions de filtre de remplacement](#lld-rule-override-filter-condition) à utiliser pour faire correspondre les objets découverts. Les conditions seront triées dans l'ordre de leur placement dans la formule.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|evaltype|integer|[Méthode d'évaluation](/manual/discovery/low_level_discovery#override) des conditions du filtre de remplacement.<br><br>Valeurs possibles :<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Expression personnalisée.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|eval\_formula|string|Expression générée qui sera utilisée pour évaluer les conditions du filtre de remplacement. L'expression contient des ID qui font référence à des conditions spécifiques du filtre de remplacement via leur `formulaid`. La valeur de `eval_formula` est égale à la valeur de `formula` pour les filtres avec une expression personnalisée.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|formula|string|Expression définie par l'utilisateur à utiliser pour évaluer les conditions des filtres de remplacement avec une expression personnalisée. L'expression doit contenir des ID qui font référence à des conditions spécifiques du filtre de remplacement via leur `formulaid`. Les ID utilisés dans l'expression doivent correspondre exactement à ceux définis dans les conditions du filtre de remplacement : aucune condition ne peut rester inutilisée ou omise.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `evaltype` est défini sur "custom expression"|

[comment]: # ({/67737988-573b52c4})

[comment]: # ({a2dc636e-e47f6c6a})
##### Condition de filtre de remplacement de règle LLD

L'objet de condition de filtre de remplacement de règle LLD définit une vérification distincte à effectuer sur la valeur d'une macro LLD. Il possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|macro|string|Macro LLD sur laquelle effectuer la vérification.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Valeur à comparer.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `operator` est défini sur "matches regular expression" ou "does not match regular expression"|
|formulaid|string|ID unique arbitraire utilisé pour référencer la condition depuis une expression personnalisée. Ne peut contenir que des lettres majuscules. L'ID doit être défini par l'utilisateur lors de la modification des conditions de filtre, mais sera généré à nouveau lors des requêtes ultérieures.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `evaltype` de [LLD rule override filter object](#lld-rule-override-filter) est défini sur "custom expression"|
|operator|integer|Opérateur de condition.<br><br>Valeurs possibles :<br>8 - *(default)* correspond à une expression régulière;<br>9 - ne correspond pas à une expression régulière;<br>12 - existe;<br>13 - n'existe pas.|

[comment]: # ({/a2dc636e-e47f6c6a})

[comment]: # ({334e5e5e-e7b08f3c})
#### Opération de remplacement de règle LLD

L'opération de remplacement de règle LLD est une combinaison de conditions et d'actions
à effectuer sur l'objet prototype. Elle possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|operationobject|integer|Type d'objet découvert sur lequel effectuer l'action.<br><br>Valeurs possibles :<br>0 - prototype d'élément;<br>1 - prototype de déclencheur;<br>2 - prototype de graphique;<br>3 - prototype d'hôte.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *required*|
|operator|integer|Opérateur de la condition de remplacement [operator](/manual/discovery/low_level_discovery#override).<br><br>Valeurs possibles :<br>0 - *(par défaut)* égal à;<br>1 - différent de;<br>2 - contient;<br>3 - ne contient pas;<br>8 - correspond à;<br>9 - ne correspond pas.|
|value|string|Motif à faire correspondre au nom du prototype d'élément, de déclencheur, de graphique ou d'hôte selon l'objet sélectionné.|
|opstatus|object|Objet d'état de l'opération de remplacement pour les objets prototype d'élément, de déclencheur et d'hôte.|
|opdiscover|object|Objet d'état de découverte de l'opération de remplacement (tous les types d'objet).|
|opperiod|object|Objet de période de l'opération de remplacement (intervalle de mise à jour) pour le prototype d'élément.|
|ophistory|object|Objet d'historique de l'opération de remplacement pour le prototype d'élément.|
|optrends|object|Objet de tendances de l'opération de remplacement pour le prototype d'élément.|
|opseverity|object|Objet de gravité de l'opération de remplacement pour le prototype de déclencheur.|
|optag|object/array|Objet de balise de l'opération de remplacement pour les prototypes de déclencheur et d'hôte.|
|optemplate|object/array|Objet de modèle de l'opération de remplacement pour le prototype d'hôte.|
|opinventory|object|Objet d'inventaire de l'opération de remplacement pour le prototype d'hôte.|

[comment]: # ({/334e5e5e-e7b08f3c})

[comment]: # ({3d3c516a-52d3b579})
##### Statut de l'opération de remplacement de règle LLD

Statut de l'opération de remplacement de règle LLD défini pour l'objet découvert. Il possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|status|integer|Remplacer le statut de l'objet sélectionné.<br><br>Valeurs possibles :<br>0 - Création activée;<br>1 - Création désactivée.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *required*|

[comment]: # ({/3d3c516a-52d3b579})

[comment]: # ({9cdd5143-ff620350})
##### Opération de substitution de règle LLD discover

Statut de l’opération de substitution de règle LLD discover qui est défini sur l’objet découvert. Il possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|discover|integer|Remplacer le statut de découverte pour l’objet sélectionné.<br><br>Valeurs possibles :<br>0 - Oui, continuer à découvrir les objets ;<br>1 - Non, les nouveaux objets ne seront pas découverts et les objets existants seront marqués comme perdus.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/9cdd5143-ff620350})

[comment]: # ({94ba958f-6e469c1b})
##### Période d'opération de remplacement de la règle LLD

La période d'opération de remplacement de la règle LLD est une valeur d'intervalle de mise à jour définie pour l'élément découvert.
Elle possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|delay|string|Remplacer l'intervalle de mise à jour du prototype d'élément.<br><br>Accepte des secondes ou une unité de temps avec suffixe (par exemple, 30s, 1m, 2h, 1d) et, éventuellement, un ou plusieurs [intervalles personnalisés](/manual/config/items/item/custom_intervals), le tout séparé par des points-virgules. Les intervalles personnalisés peuvent combiner des intervalles flexibles et des intervalles de planification.<br><br>Accepte des macros utilisateur ou des macros LLD (la prise en charge des macros LLD a été rétablie dans Zabbix 7.0.27). Si cette option est utilisée, la valeur doit être une seule macro. Plusieurs macros ou des macros mélangées à du texte ne sont pas prises en charge. Les intervalles flexibles peuvent être écrits sous forme de deux macros séparées par une barre oblique (par exemple, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Exemple :<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *required*|

[comment]: # ({/94ba958f-6e469c1b})

[comment]: # ({a8b2ff35-ff97489f})
##### Historique de la valeur de l'opération de remplacement de la règle LLD

Valeur de l'historique de remplacement de la règle LLD qui est définie pour l'élément découvert. Elle possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|history|string|Remplace l'historique du prototype d'élément, qui correspond à une unité de temps indiquant pendant combien de temps les données d'historique doivent être conservées. Accepte également une macro utilisateur et une macro LLD (la prise en charge des macros LLD a été rétablie dans Zabbix 7.0.27).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/a8b2ff35-ff97489f})

[comment]: # ({414499ea-10b52601})
##### Tendances de l'opération de remplacement de la règle LLD

Valeur des tendances de l'opération de remplacement de la règle LLD qui est définie pour l'élément découvert.
Elle possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|trends|string|Remplacer les tendances du prototype d'élément, qui correspond à une unité de temps indiquant pendant combien de temps les données de tendances doivent être conservées. Accepte également une macro utilisateur et une macro LLD (la prise en charge des macros LLD a été rétablie dans Zabbix 7.0.27).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/414499ea-10b52601})

[comment]: # ({e551a258-991f3bdc})
##### Sévérité de l'opération de remplacement de règle LLD

Valeur de sévérité de l'opération de remplacement de règle LLD qui est définie pour le déclencheur découvert. Elle possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|severity|integer|Remplacer la sévérité du prototype de 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.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *required*|

[comment]: # ({/e551a258-991f3bdc})

[comment]: # ({427bdb05-0693b8f3})
##### Balise d'opération de remplacement de règle LLD

L'objet de balise d'opération de remplacement de règle LLD contient le nom et la valeur de la balise qui sont définis pour l'objet découvert. Il possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|tag|string|Nouveau nom de balise. Accepte également une macro utilisateur et une macro LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Nouvelle valeur de balise. Accepte également une macro utilisateur et une macro LLD.|

[comment]: # ({/427bdb05-0693b8f3})

[comment]: # ({0e075e84-5eebc05a})
##### Modèle d'opération de remplacement de règle LLD

Objet de modèle d'opération de remplacement de règle LLD lié à l'hôte découvert. Il possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|templateid|ID|Remplacer le modèle des modèles liés du prototype d'hôte.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

[comment]: # ({/0e075e84-5eebc05a})

[comment]: # ({e26c68ed-9c5cc3d1})
##### Inventaire de l'opération de substitution de règle LLD

Valeur du mode d'inventaire de l'opération de substitution de règle LLD qui est définie pour l'hôte découvert. Elle possède les propriétés suivantes :

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|inventory\_mode|integer|Remplacer le mode d'inventaire du prototype d'hôte.<br><br>Valeurs possibles :<br>-1 - désactivé;<br>0 - *(par défaut)* manuel;<br>1 - automatique.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *required*|

[comment]: # ({/e26c68ed-9c5cc3d1})
