[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]: # ({33580c07-c17fa830})
### Règle LLD

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

|Propriété|[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 exemple, 30s, 1m, 2h, 1d) et, éventuellement, un ou plusieurs [intervalles personnalisés](/manual/config/items/item/custom_intervals), tous séparés par des points-virgules. Les intervalles personnalisés peuvent être un mélange d'intervalles flexibles et planifiés.<br><br>Accepte les macros utilisateur. Si elles sont utilisées, la valeur doit être une macro unique. Plusieurs macros ou des macros mélangées avec 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>- *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|
|flags|integer|[Origine](/manual/api/reference_commentary#entity-origin-flags) de la règle de découverte.<br><br>Valeurs possibles :<br>1 - une règle de découverte de bas niveau ;<br>5 - une règle de découverte de bas niveau convertie à partir d'un prototype.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *lecture seule*|
|interfaceid|ID|ID de l'interface d'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 - élément dépendant ;<br>19 - HTTP agent ;<br>20 - SNMP agent ;<br>21 - Script ;<br>22 - Browser ;<br>23 - Imbriqué. Ce type n'est autorisé que si le parent de la règle est un modèle (supposé être lié à un prototype d'hôte lors de la découverte) ou un hôte découvert (qui possède une règle LLD à sa racine).<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 URL.<br>Prend en charge les macros utilisateur, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {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|Autorise le remplissage de la valeur de manière similaire à l'élément trapper.<br><br>Valeurs possibles :<br>0 - *(par défaut)* Ne pas autoriser l'acceptation de données entrantes ;<br>1 - Autoriser l'acceptation de 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 s'il y a des problèmes 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 l'interrogation 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 des [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 JMX agent.<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 après que le seuil de durée de vie soit 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 après que le seuil de durée de vie soit 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>Une règle de découverte ne peut pas être un élément maître pour 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 brut ;<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>- le 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 "JSON data" ou "XML data"<br>- *pris en charge* si `type` est défini sur "HTTP agent" et que `post_type` est défini sur "Raw data"<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 "public key"|
|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 "public key"|
|query\_fields|array|Tableau des [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 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 des codes d'état HTTP requis, séparées par des virgules. Prend également en charge les macros utilisateur comme partie d'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'expiration de la requête d'interrogation des données de l'élément.<br>Accepte des secondes ou une unité de temps avec suffixe (par exemple, 30s, 1m). Accepte également les macros utilisateur.<br><br>Plage de valeurs possibles : 1-600s.<br><br>Par défaut : "" - utiliser les paramètres proxy/globaux.<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 "Allow to accept incoming data"|
|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 universel unique, utilisé pour lier les règles LLD importées à celles qui existent déjà. 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]: # ({/33580c07-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 de 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 évaluer les 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]: # ({92f63faf-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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Valeur à comparer.<br><br>[Property behavior](/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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* si `evaltype` de [LLD rule filter object](#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]: # ({/92f63faf-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>[Property behavior](/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>[Property behavior](/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>[Property behavior](/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>[Property behavior](/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 ex. 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 (metric, label name, label value et metric
value) 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 une correspondance est trouvée.<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>- *read-only*|
|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 [l'objet de filtre de remplacement de règle LLD](#lld-rule-override-filter) est défini sur "custom expression"|
|operator|integer|Opérateur de condition.<br><br>Valeurs possibles :<br>8 - *(default)* correspond à l'expression régulière;<br>9 - ne correspond pas à l'expression régulière;<br>12 - existe;<br>13 - n'existe pas.|

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

[comment]: # ({02af08bb-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>4 - prototype de découverte.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|operator|integer|[Opérateur](/manual/discovery/low_level_discovery#override) de la condition de remplacement.<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|Modèle à 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 l'objet prototype d'élément.|
|ophistory|object|Objet d'historique de l'opération de remplacement pour l'objet prototype d'élément.|
|optrends|object|Objet de tendances de l'opération de remplacement pour l'objet prototype d'élément.|
|opseverity|object|Objet de gravité de l'opération de remplacement pour l'objet prototype de déclencheur.|
|optag|object/array|Objet de balise de l'opération de remplacement pour les objets prototype de déclencheur et d'hôte.|
|optemplate|object/array|Objet de modèle de l'opération de remplacement pour l'objet prototype d'hôte.|
|opinventory|object|Objet d'inventaire de l'opération de remplacement pour l'objet prototype d'hôte.|

[comment]: # ({/02af08bb-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

L'opération de substitution de règle LLD discover du statut défini sur l'objet découvert. Elle 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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

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

La période d'opération de surcharge de 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 :

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|delay|string|Remplace 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), tous séparés par des points-virgules. Les intervalles personnalisés peuvent être un mélange d'intervalles flexibles et d'intervalles planifiés.<br><br>Accepte des macros utilisateur ou des macros LLD. Si elles sont utilisées, la valeur doit être une macro unique. Plusieurs macros ou des macros mélangées avec du texte ne sont pas prises en charge. Les intervalles flexibles peuvent être écrits sous la 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]: # ({/b3bef187-6e469c1b})

[comment]: # ({28d8eca2-ff97489f})
##### Historique des opérations de remplacement de règle LLD

Valeur de l'historique des opérations de remplacement de règle LLD qui est définie sur 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 les macros utilisateur et les macros LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({a1ea1935-10b52601})
##### Tendances de l'opération de substitution de règle LLD

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

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|trends|string|Remplace les tendances du prototype d'élément, c'est-à-dire l'unité de temps pendant laquelle les données de tendances doivent être conservées. Accepte également une macro utilisateur et une macro LLD.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|

[comment]: # ({/a1ea1935-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|Remplace la sévérité du prototype de déclencheur.<br><br>Valeurs possibles :<br>0 - *(par défaut)* non classifié;<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>- *requis*|

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

[comment]: # ({71613716-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.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Nouvelle valeur de balise.|

[comment]: # ({/71613716-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 remplacement de règle LLD

Valeur du mode d'inventaire de l'opération de remplacement 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|Remplace 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})
