[comment]: # aside: 1

[comment]: # ({d1f57367-6bb9f60f})
# Objet item

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

[comment]: # ({/d1f57367-6bb9f60f})

[comment]: # ({68ea2686-385ac8b5})
### Élément

::: noteclassic
Les éléments web ne peuvent pas être créés, mis à jour ou supprimés directement via l'API Zabbix.
:::

L'objet élément possède les propriétés suivantes.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID de l'élément.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations|
|delay|string|Intervalle de mise à jour de l'é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 les macros utilisateur. Si elle est utilisée, 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 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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "Calculated" (15), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), or if `type` is set to "Zabbix agent (active)" (7) and `key_` does not contain "mqtt.get"|
|hostid|ID|ID de l'hôte ou du modèle auquel appartient l'élément.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations|
|interfaceid|ID|ID de l'interface de l'hôte de l'élément.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if item belongs to host and `type` is set to "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap", or "SNMP agent"<br>- *supported* if item belongs to host and `type` is set to "Simple check", "External check", "SSH agent", "TELNET agent", or "HTTP agent"<br>- *read-only* for discovered objects|
|key\_|string|Clé de l'élément.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|name|string|Nom de l'élément.<br>Prend en charge les macros utilisateur.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|name\_resolved|string|Nom de l'élément avec les macros utilisateur résolues.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|type|integer|Type de l'élément.<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>9 - Web item;<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>15 - Calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script;<br>22 - Browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|url|string|Chaîne d'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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|value\_type|integer|Type d'information de l'élément.<br><br>Valeurs possibles:<br>0 - nombre flottant;<br>1 - caractère;<br>2 - journal;<br>3 - entier non signé;<br>4 - texte;<br>5 - binaire.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects or discovered objects|
|allow\_traps|integer|Autoriser le remplissage de la valeur de la même manière que pour l'élément trapper.<br><br>0 - *(default)* Ne pas autoriser l'acceptation des données entrantes;<br>1 - Autoriser l'acceptation des données entrantes.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for discovered objects|
|authtype|integer|Méthode d'authentification.<br><br>Valeurs possibles si `type` est défini sur "SSH agent":<br>0 - *(default)* mot de passe;<br>1 - clé publique.<br><br>Valeurs possibles si `type` est défini sur "HTTP agent":<br>0 - *(default)* aucune;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "SSH agent" or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent") or discovered objects|
|description|string|Description de l'élément.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for discovered objects|
|error|string|Texte d'erreur s'il y a des problèmes lors de la mise à jour de la valeur de l'élément.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|flags|integer|[Origine](/manual/api/reference_commentary#entity-origin-flags) de l'élément.<br><br>Valeurs possibles:<br>0 - un élément simple;<br>4 - un élément converti depuis un prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|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 - *(default)* Suivre les redirections.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|history|string|Une unité de temps indiquant pendant combien de temps les données d'historique doivent être conservées.<br>Accepte également une macro utilisateur.<br><br>Par défaut: 31d.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for discovered objects|
|http\_proxy|string|Chaîne de connexion du proxy HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|inventory\_link|integer|ID du champ d'inventaire de l'hôte renseigné par l'élément.<br><br>Consultez la [page d'inventaire de l'hôte](/manual/api/reference/host/object#host-inventory) pour obtenir la liste des champs d'inventaire pris en charge et leurs ID.<br><br>Par défaut: 0.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float", "character", "numeric unsigned", or "text"<br>- *read-only* for discovered objects|
|ipmi\_sensor|string|Capteur IPMI.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "IPMI agent" and `key_` is not set to "ipmi.get"<br>- *supported* if `type` is set to "IPMI agent"<br>- *read-only* for inherited objects or discovered objects|
|jmx\_endpoint|string|Chaîne de connexion personnalisée de l'agent JMX.<br><br>Valeur par défaut: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "JMX agent"<br>- *read-only* for discovered objects|
|lastclock|timestamp|Heure à laquelle la valeur de l'élément a été mise à jour pour la dernière fois.<br><br>Par défaut, seules les valeurs comprises dans les dernières 24 heures sont affichées. Vous pouvez étendre cette période en modifiant la valeur du paramètre *Max history display period* dans la section de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|lastns|integer|Nanosecondes à laquelle la valeur de l'élément a été mise à jour pour la dernière fois.<br><br>Par défaut, seules les valeurs comprises dans les dernières 24 heures sont affichées. Vous pouvez étendre cette période en modifiant la valeur du paramètre *Max history display period* dans la section de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|lastvalue|string|Dernière valeur de l'élément.<br><br>Par défaut, seules les valeurs comprises dans les dernières 24 heures sont affichées. Vous pouvez étendre cette période en modifiant la valeur du paramètre *Max history display period* dans la section de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|logtimefmt|string|Format de l'heure dans les entrées de journal.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "log"<br>- *read-only* for inherited objects or discovered objects|
|master\_itemid|ID|ID de l'élément maître.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Dependent item"<br>- *read-only* for inherited objects or discovered objects|
|output\_format|integer|La réponse doit-elle être convertie en JSON.<br><br>0 - *(default)* Stocker les données brutes;<br>1 - Convertir en JSON.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|params|string|Paramètres supplémentaires selon le type de l'élément:<br>- script exécuté pour les éléments SSH agent et TELNET agent;<br>- requête SQL pour les éléments database monitor;<br>- formule pour les éléments calculated;<br>- script pour les éléments script et browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script", or "Browser"<br>- *read-only* for inherited objects (if `type` is set to "Script" or "Browser") or discovered objects|
|parameters|object/array|Paramètres supplémentaires si `type` est défini sur "Script" ou "Browser". Tableau d'objets avec les propriétés `name` et `value`, où `name` doit être unique.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Script" or "Browser"<br>- *read-only* for inherited objects or discovered objects|
|password|string|Mot de passe pour l'authentification.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "JMX agent" and `username` is set<br>- *supported* if `type` is set to "Simple check", "SSH agent", "TELNET agent", "Database monitor", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent") or discovered objects|
|post\_type|integer|Type du corps des données POST stocké dans la propriété `posts`.<br><br>Valeurs possibles:<br>0 - *(default)* Données brutes;<br>2 - Données JSON;<br>3 - Données XML.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|posts|string|Données du corps de la requête HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "HTTP agent" and `post_type` is set to "JSON data" or "XML data"<br>- *supported* if `type` is set to "HTTP agent" and `post_type` is set to "Raw data"<br>- *read-only* for inherited objects or discovered objects|
|prevvalue|string|Valeur précédente de l'élément.<br><br>Par défaut, seules les valeurs comprises dans les dernières 24 heures sont affichées. Vous pouvez étendre cette période en modifiant la valeur du paramètre *Max history display period* dans la section de menu *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|privatekey|string|Nom du fichier de clé privée.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"<br>- *read-only* for discovered objects|
|publickey|string|Nom du fichier de clé publique.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent" and `authtype` is set to "public key"<br>- *read-only* for discovered objects|
|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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|request\_method|integer|Type de méthode de requête.<br><br>Valeurs possibles:<br>0 - *(default)* GET;<br>1 - POST;<br>2 - PUT;<br>3 - HEAD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|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 - *(default)* 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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|snmp\_oid|string|OID SNMP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP agent"<br>- *read-only* for inherited objects or discovered objects|
|ssl\_cert\_file|string|Chemin du fichier de clé SSL publique.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|ssl\_key\_file|string|Chemin du fichier de clé SSL privée.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|ssl\_key\_password|string|Mot de passe du fichier de clé SSL.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|state|integer|État de l'élément.<br><br>Valeurs possibles:<br>0 - *(default)* normal;<br>1 - non pris en charge.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|status|integer|Statut de l'élément.<br><br>Valeurs possibles:<br>0 - *(default)* élément activé;<br>1 - élément désactivé.|
|status\_codes|string|Plages de codes d'état HTTP requis, séparées par des virgules.<br>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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|templateid|ID|ID de l'élément de modèle parent.<br><br>*Conseil*: utilisez la propriété `hostid` pour spécifier le modèle auquel l'élément appartient.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|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 exemple, 30s, 1m). Accepte également les macros utilisateur.<br><br>Plage de valeurs possible: 1-600s.<br><br>Par défaut: "" - utiliser les paramètres du proxy/global.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "Zabbix agent" (0), "Simple check" (3) and `key_` does not start with "`vmware.`" and "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) and `snmp_oid` starts with "`walk[`" or "`get[`", "Script" (21), "Browser" (22)<br>- *read-only* for inherited and discovered objects|
|trapper\_hosts|string|Hôtes autorisés.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *readonly* for discovered objects<br>- *supported* if `type` is set to "Zabbix trapper", or if `type` is set to "HTTP agent" and `allow_traps` is set to "Allow to accept incoming data"|
|trends|string|Une unité de temps indiquant pendant combien de temps les données de tendances doivent être conservées.<br>Accepte également une macro utilisateur.<br><br>Par défaut: 365d.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float" or "numeric unsigned"<br>- *read-only* for discovered objects|
|units|string|Unités de la valeur.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float" or "numeric unsigned"<br>- *read-only* for inherited objects or discovered objects|
|username|string|Nom d'utilisateur pour l'authentification.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SSH agent", "TELNET agent", or if `type` is set to "JMX agent" and `password` is set<br>- *supported* if `type` is set to "Simple check", "Database monitor", or "HTTP agent"<br>- *read-only* for inherited objects (if `type` is set to "HTTP agent") or discovered objects|
|uuid|string|Identifiant unique universel, utilisé pour lier l'élément importé à des éléments déjà existants. Généré automatiquement s'il n'est pas fourni.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the item belongs to a template|
|valuemapid|ID|ID de la carte de valeurs associée.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `value_type` is set to "numeric float", "character", or "numeric unsigned"<br>- *read-only* for inherited objects or discovered objects|
|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 - *(default)* Ne pas valider;<br>1 - Valider.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|
|verify\_peer|integer|Indique s'il faut valider que le certificat de l'hôte est authentique.<br><br>Valeurs possibles:<br>0 - *(default)* Ne pas valider;<br>1 - Valider.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `type` is set to "HTTP agent"<br>- *read-only* for inherited objects or discovered objects|

[comment]: # ({/68ea2686-385ac8b5})

[comment]: # ({ab5307fa-7efc456e})
#### 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>- *obligatoire*|
|value|string|Valeur de l'en-tête.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|

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

[comment]: # ({5b4177f3-ee8852f1})
#### 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-ee8852f1})

[comment]: # ({c9a1b21e-c1b98afa})
### Balise d'élément

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

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

[comment]: # ({/c9a1b21e-c1b98afa})

[comment]: # ({eed27a12-2169bb78})
### Prétraitement de l'élément

L'objet de prétraitement de l'élément 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>1 - Multiplicateur personnalisé;<br>2 - Suppression à droite;<br>3 - Suppression à gauche;<br>4 - Suppression;<br>5 - Expression régulière;<br>6 - Booléen vers décimal;<br>7 - Octal vers décimal;<br>8 - Hexadécimal vers décimal;<br>9 - Changement simple;<br>10 - Variation par seconde;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - Dans l'intervalle;<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>18 - Vérifier l'erreur à l'aide d'une expression régulière;<br>19 - Ignorer les valeurs inchangées;<br>20 - Ignorer les valeurs inchangées avec heartbeat;<br>21 - JavaScript;<br>22 - Modèle Prometheus;<br>23 - Prometheus vers JSON;<br>24 - CSV vers JSON;<br>25 - Remplacer;<br>26 - Vérifier non pris en charge;<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.<br>Les paramètres multiples sont séparés par le caractère de nouvelle ligne (\\n).<br><br>Si `type` est défini sur "Check unsupported", les paramètres suivent la syntaxe `<scope>[\n<pattern>]`, où *pattern* est une expression régulière et *scope* est l'une des valeurs suivantes :<br>-1 - correspond à toute erreur;<br>\ 0 - vérifier si le message d'erreur correspond à *pattern*;<br>\ 1 - vérifier si le message d'erreur ne correspond pas à *pattern*.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required* si `type` est défini sur "Custom multiplier" (1), "Right trim" (2), "Left trim" (3), "Trim" (4), "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Discard unchanged with heartbeat" (20), "JavaScript" (21), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Replace" (25), Check unsupported (26), "SNMP walk value" (28), "SNMP walk to JSON" (29), or "SNMP get value" (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>Valeurs possibles si `type` est défini sur "Check unsupported" :<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 "Custom multiplier" (1), "Regular expression" (5), "Boolean to decimal" (6), "Octal to decimal" (7), "Hexadecimal to decimal" (8), "Simple change" (9), "Change per second" (10), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Check unsupported" (26), "XML to JSON" (27), "SNMP walk value" (28), "SNMP walk to JSON" (29), or "SNMP get value" (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 "Set custom value" ou "Set custom error message"|

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|
|------------------|----|-----------|-----------|-----------|------------------------|
|1|Multiplicateur personnalisé|number^1, 6^|<|<|0, 1, 2, 3|
|2|Suppression à droite|list of characters^2^|<|<|<|
|3|Suppression à gauche|list of characters^2^|<|<|<|
|4|Suppression|list of characters^2^|<|<|<|
|5|Expression régulière|pattern^3^|output^2^|<|0, 1, 2, 3|
|6|Booléen vers décimal|<|<|<|0, 1, 2, 3|
|7|Octal vers décimal|<|<|<|0, 1, 2, 3|
|8|Hexadécimal vers décimal|<|<|<|0, 1, 2, 3|
|9|Changement simple|<|<|<|0, 1, 2, 3|
|10|Variation par seconde|<|<|<|0, 1, 2, 3|
|11|XML XPath|path^4^|<|<|0, 1, 2, 3|
|12|JSONPath|path^4^|<|<|0, 1, 2, 3|
|13|Dans l'intervalle|min^1, 6^|max^1, 6^|<|0, 1, 2, 3|
|14|Correspond à l'expression régulière|pattern^3^|<|<|0, 1, 2, 3|
|15|Ne correspond pas à l'expression régulière|pattern^3^|<|<|0, 1, 2, 3|
|16|Vérifier l'erreur dans JSON|path^4^|<|<|0, 1, 2, 3|
|17|Vérifier l'erreur dans XML|path^4^|<|<|0, 1, 2, 3|
|18|Vérifier l'erreur à l'aide d'une expression régulière|pattern^3^|output^2^|<|0, 1, 2, 3|
|19|Ignorer les valeurs inchangées|<|<|<|<|
|20|Ignorer les valeurs inchangées avec heartbeat|seconds^5, 6^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|22|Modèle Prometheus|pattern^6, 7^|`value`, `label`, `function`|output^8, 9^|0, 1, 2, 3|
|23|Prometheus vers JSON|pattern^6, 7^|<|<|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^|<|<|
|26|Vérifier non pris en charge|scope^1^|pattern^3, 6^|<|1, 2, 3|
|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^10^|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^ nombre à virgule flottante (les entiers sont convertis implicitement en valeurs flottantes)<br>
^2^ chaîne<br>
^3^ expression régulière<br>
^4^ JSONPath ou XML XPath<br>
^5^ entier positif (avec prise en charge des suffixes de temps, par exemple 30s, 1m, 2h,
1d)<br>
^6^ macro utilisateur<br>
^7^ modèle Prometheus suivant la syntaxe :
`<metric name>{<label name>="<label value>", ...} == <value>`. Chaque
composant du modèle Prometheus (métrique, nom d'étiquette, valeur d'étiquette et valeur de métrique) peut être une macro utilisateur.<br>
^8^ sortie Prometheus suivant la syntaxe : `<label name>` (peut être une macro utilisateur) si `label` est sélectionné comme deuxième paramètre.<br>
^9^ L'une des fonctions d'agrégation : `sum`, `min`, `max`, `avg`, `count` si `function` est sélectionné comme deuxième paramètre.<br>
^10^ Prend en charge plusieurs enregistrements "Field name,OID prefix,Format records" délimités par un caractère de nouvelle ligne.

[comment]: # ({/eed27a12-2169bb78})