[comment]: # translation:outdated

[comment]: # ({6bb9f60f-6bb9f60f})
# > Element objecte

Els següents objectes tenen relació directa amb l'API `item`.

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

[comment]: # ({31a17c9a-385ac8b5})
### Element

::: noteclassic
Els elements web no es poden crear, actualitzar o esborrar directament mitjançant l'API de Zabbix.
:::

L'objecte element té les propietats següents.

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|itemid|string|ID de l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització|
|delay|string|Interval d'actualització de l'element. Accepta segons o una unitat de temps amb sufix (30s, 1m, 2h, 1d).<br>Opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) es poden especificar com a intervals flexibles o com una programació.<br>Múltiples intervals estan separats per un punt i coma.<br>Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten pas diverses macros en un camp o macros barrejades amb text.<br>Els intervals flexibles es poden escriure com dues macros separades per una barra inclinada (p. ex., `{$FLEX_INTERVAL}/ {$FLEX_PERIOD}`).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` s'ha establert a "Agent Zabbix" (0), "Verificacions simples" (3), "Intern Zabbix" (5), "Verificacions externes" (10), "Monitoratge de base de dades" (11), "Agent IPMI" (12), "Agent SSH" (13), "Agent TELNET" (14), "Calculat" (15), "Agent JMX (16), "Agent HTTP" (19), "Agent SNMP" (20), "Script" (21), o si `type` s'ha establert a "Agent actiu de Zabbix" (7) i `key_` no conté pas "mqtt.get"|
|hostid|string|ID de l'equip o del model al qual pertany l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *obligatori* per operacions de creació.|
|interfaceid|string|Id de la interfície d'equip de l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'element pertany a l'equip i `type` és "Agent Zabbix", "Agent IPMI", "Agent JMX", "Traça SNMP", o "Agent SNMP"<br>- *admès* si l'element pertant a l'equip i `type` és "Validació simple", "Validació externa", "Agent SSH", "Agent TELNET", o "Agent HTTP"<br>- *només lectura* per objectes descoberts|
|key\_|string|Clau d'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions de creació<br>- *només lectura* per objectes heretats o descoberts|
|name|string|Nom de l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions de creació<br>- *només lectura* per objectes heretats o descoberts|
|type|integer|Tipus d'element<br><br>Valors possibles:<br>0 - Agent Zabbix;<br>2 - Trapper Zabbix;<br>3 - Verificació simple; <br>5 - Zabbix intern;<br>7 - Agent Zabbix (actiu);<br>9 - Element web;<br>10 - Verificació externa;<br>11 - Monitor de base de dades;< 12 - Agent IPMI;< br>13 - Agent SSH;<br>14 - Agent Telnet;<br>15 - Calculat;<br>16 - Agent JMX;<br>17 - Trampa SNMP;<br>18 - Element dependent;<br>19 - Agent HTTP;<br>20 - Agent SNMP;<br>21 - Script.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|url|string|cadena d'URL, necessària només per al tipus d'element d'agent HTTP. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació<br>- *només lectura* per objectes heretats o descoberts|
|value\_type|integer|Tipus d'informació de l'element.<br><br>Valors possibles:<br>0 - nombre flotant;<br>1 - caràcter; <br> 2 - diari;<br>3 - digital sense signe;<br>4 - text.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions de creació<br>- *només lectura* per objectes heretats o descoberts|
|allow\_traps|integer|camp d'element de l'agent HTTP. També permet l'ampliació de valors com en el tipus d'element trapper.<br><br>0 - *(per defecte)* No permet acceptar dades entrants.<br>1 - Permet acceptar dades entrants.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes descoberts|
|authtype|integer|Només l'empren els elements de l'agent SSH o els elements de l'agent HTTP.<br><br>Valors possibles per al mètode d'autenticació de l'agent SSH:<br>0 - mot de pas *(per defecte)*;<br>1 - clau pública.<br><br> Valors possibles del mètode d'autenticació de l'agent HTTP:<br>0 - *(per defecte)* cap<br> 1 - Bàsic<br>2 - NTLM<br>3 - Kerberos<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent SSH" o "Agent HTTP"<br>- *només lectura* per objectes heretats (si `type` és "Agent HTTP") o objectes descoberts|
|description|string|Descripció de l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura* per objectes descoberts|
|error|string|Text d'error si hi ha problemes per actualitzar el valor de l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|flags|integer|Origen de l'objecte.<br><br>Valors possibles:<br>0 - Objecte normal;<br>4 - Objecte descobert.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|follow\_redirects|integer|Camp d'element de l'agent HTTP. Seguiu les redireccions de respostes mentre afegiu dades.<br><br>0 - No seguiu les redireccions.<br>1 - *(per defecte)* Seguiu les redireccions.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|headers|object|Camp d'element de l'agent HTTP. Objecte amb capçaleres de petició HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor.<br><br>Exemple:<br>{ " User-Agent": "Zabbix" }<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|history|string|Unitat de temps que indica quant de temps s'han d'emmagatzemar les dades de l'històric. També accepta macros d'usuari.<br><br>Per defecte: 90d.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura* per objectes descoberts|
|http\_proxy|string|camp d'element de l'agent HTTP. Cadena de connexió del proxy HTTP(S).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent SSH" <br>- *només lectura* per objectes heretats o descoberts|
|inventory\_link|integer|ID del camp d'inventari de l'equip emplenat per l'element.<br><br>Consulteu la [pàgina d'inventari d'equip](/manual/api/reference/host/object#host_inventory) per obtindre una llista de camps d'inventari d'equip admesos i els seus identificadors.<br><br>Per defecte: 0.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `value_type` és "numèric flotant", "caràcter", "numèric sense signe" o "text"<br>- *només lectura* per objectes descoberts|
|ipmi\_sensor|string|sensor IPMI. Emprat només per elements IPMI.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent IPMI" i `key_` no és "ipmi.get"<br>- *admès* si `type` és "Agent IPMI"<br>- *només lectura* per objectes heretats o descoberts|
|jmx\_endpoint|string|Cadena de connexió de l'agent JMX personalitzada.<br><br>Per defecte:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent JMX"<br>- *només lectura* per objectes descoberts|
|lastclock|timestamp|Hora en què l'element es va actualitzar per darrer cop.<br><br>Per defecte, només es mostren els valors de les darreres 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|lastns|integer|*(només lectura)* Nanosegons de la darrera actualització de l'element.<br><br>De manera predeterminada, només es mostren els valors de les darreres 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|lastvalue|string|*(només lectura)* Darrer valor de l'element.<br><br>Per defecte, només es mostren els valors de les darreres 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|logtimefmt|string|Format d'hora a les entrades de registre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `value_type` és "log"<br>- *només lectura* per objectes heretats o descoberts|
|master\_itemid|integer|Identificador d'element principal.<br>Es permet la recurrència de fins a 3 elements dependents i el nombre màxim d'elements dependents de 29.999.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Element dependent"<br>- *només lectura* per objectes heretats o descoberts|
|output\_format|integer|Camp d'element de l'agent HTTP. En cas de convertir la resposta a JSON.<br><br>0 - *(per defecte)* Emmagatzema en brut.<br>1 - Converteix a JSON.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|params|string|Paràmetres addicionals en funció del tipus d'element:<br>- script executat per a elements SSH i Telnet;<br>- consulta SQL per a elements de supervisió de la base de dades;<br>- fórmula per als elements calculats;<br>- l'script per a un element d'script.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent SSH", "Agent TELNET", "Calculat" o "Script"<br>- *només lectura* per objectes heretats (si `type` és "Script") o objectes descoberts|
|parameters|array|Paràmetres addicionals per als elements de l'script. Matriu d'objectes amb propietats "nom" i "valor", on el nom ha d'ésser únic.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Script"<br>- *només lectura* per objectes heretats o descoberts|
|password|string|Mot de pas per a l'autenticació. S'empra per simple comprovació, SSH, Telnet, monitor de base de dades, elements de l'agent JMX i HTTP.<br>Quan s'empra per JMX, el nom d'usuari també s'ha d'especificar amb mot de pas o ambdues propietats s'han de deixar buides.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Verificació simple", "Agent SSH", "Agent TELNET", "Monitoratge de base de dades" o "Agent HTTP"<br>- *només lectura* per objectes heretats (si `type` és "Agent HTTP") o objectes descoberts|
|post\_type|integer|camp d'element de l'agent HTTP. Tipus de cos de dades de publicació emmagatzemat a la propietat de publicacions.<br><br>0 - *(per defecte)* Dades en brut.<br>2 - Dades JSON.<br>3 - Dades XML.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|posts|string|camp d'element de l'agent HTTP. HTTP(S) demana dades del cos. S'empra amb post\_type.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent HTTP" i `post_type` és "Dades JSON" o "Dades XML"<br>- *admès* si `type` és "Agent HTTP" i `post_type` és "Dades en brut"<br>- *només lectura* per objectes heretats o descoberts|
|prevvalue|string|Valor anterior de l'element.<br><br>Per defecte, només es veuen els valors de les últimes 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|privatekey|string|Nom del fitxer de clau privada.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent SSH" i `authtype` és "clau pública"<br>- *només lectura* per objectes descoberts|
|publickey|string|Nom del fitxer de clau pública.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent SSH" i `authtype` és "clau pública"<br>- *només lectura* per objectes descoberts|
|query\_camps|array|Camp d'element de l'agent HTTP. Paràmetres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor pot ésser una cadena buida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|request\_method|integer|Camp d'element de l'agent HTTP. Tipus de mètode de petició.<br><br>0 - *(per defecte)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|retrieve\_mode|integer|camp d'element de l'agent HTTP. Quina part de la resposta s'ha d'emmagatzemar.<br><br>0 - *(per defecte)* Cos.<br>1 - Capçaleres.<br>2 - S'emmagatzemaran el cos i les capçaleres.< br><br>Per request\_method HEAD only 1 és el valor permès.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|snmp\_oid|string|SNMP OID.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent SNMP"<br>- *només lectura* per objectes heretats o descoberts|
|ssl\_cert\_file|string|Camp d'element de l'agent HTTP. Camí al fitxer de clau SSL pública.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|ssl\_key\_file|string|Camp d'element de l'agent HTTP. Camí al fitxer de clau SSL privada.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|ssl\_key\_password|string|Camp d'element de l'agent HTTP. Mot de pas per al fitxer de clau SSL.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|state|integer|Estat de l'element.<br><br>Valors possibles:<br>0 - *(per defecte)* normal;<br>1 - no compatible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|status|integer|Estat de l'element.<br><br>Valors possibles:<br>0 - element activat *(per defecte)*;<br>1 - element desactivat.|
|status\_codes|string|camp d'element de l'agent HTTP. Intervals de codis d'estat HTTP obligatoris separats per comes. També admet macros d'usuari com a part d'una llista separada per comes.<br><br>Exemple: 200.200-{$M},{$M},200-400<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|templateid|string|(només lectura) ID de l'element de la plantilla principal.<br><br>*Consell*: Empreu la propietat `hostid` per especificar la plantilla a la qual pertany l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|timeout|string|Temps d'espera de la petició de consulta de dades d'element. S'empra per a agents HTTP i elements d'script. Admet macros d'usuari.<br><br>valor per defecte: 3s<br>valor màxim: 60s<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP" o "Script"<br>- *només lectura* per objectes heretats o descoberts|
|trapper\_hosts|string|Equips permesos. Emprat per elements trapper o elements d'agent HTTP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura* per objectes descoberta<br>- *admès* si `type` és "Agent HTTP" i `allow_traps` és "Permetre acceptar dades entrants"|
|trends|string|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendències. També accepta macros d'usuari.<br><br>Per defecte: 365d.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `value_type` és "numèric flotant" o "numèric sense signe"<br>- *només lectura* per objectes descoberts|
|units|string|Unitats de valor.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `value_type` és "numèric flotant" o "numèric sense signe"<br>- *només lectura* per objectes heretats o descoberts|
|username|string|Nom d'usuari per a l'autenticació.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Agent SSH", "Agent TELNET", o si `type` és "Agent JMX" i `password` s'ha definit<br>- *admès* si `type` és "Verificació simple", "Monitoratge de base de dades" o "Agent HTTP"<br>- *només lectura* per objectes heretats (si `type` és "Agent HTTP") o descoberts|
|uuid|string|Identificador únic universal, emprat per enllaçar un element importat amb elements ja existents. Es genera automàticament, si no es proporciona.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si l'element pertany a una plantilla|
|valuemapid|string|ID del mapa de valor associat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `value_type` és "numèric flotant", "caràcter" o "numèric sense signe"<br>- *només lectura* per objectes heretats o descoberts|
|verify\_host|integer|camp d'element d'agent HTTP. Valideu que el nom d'equip a l'URL estigui al camp Nom comú o Nom alternatiu del subjecte del certificat d'equip.<br><br>0 - *(per defecte)* No valida. <br>1 - Valida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|
|verify\_peer|integer|camp d'element de l'agent HTTP. Valida si el certificat de l'equip és autèntic.<br><br>0 - *(per defecte)* No valida.<br>1 - Valida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `type` és "Agent HTTP"<br>- *només lectura* per objectes heretats o descoberts|

[comment]: # ({/31a17c9a-385ac8b5})

[comment]: # ({eb739296-c1b98afa})
### Etiqueta d'element

L'objecte d'etiqueta d'element té les propietats següents:

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|tag|string|Nom de l'etiqueta de l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|value|string|Valor de l'etiqueta de l'element.|

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

[comment]: # ({35d50fe1-2169bb78})
### Preprocessament de l'element

L'objecte té les propietats següents.

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|type|integer|El tipus d'opció de preprocessament.<br><br>Valors possibles:<br>1 - Multiplicador personalitzat;<br>2 - Retalla a la dreta;< br>3 - Retalla a l'esquerra;<br>4 - Retalla;<br>5 - Coincidència d'expressió regular;<br>6 - Booleà a decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br> 9 - Canvi únic;<br>10 - Canvi per segon;<br>11 - XML ​​​​XPath;<br>12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular;< br>15 - No coincideix amb l'expressió regular;<br>16 - Comprova si hi ha errors en JSON;<br>17 - Comprova si hi ha errors en XML;<br>18 - Comprova si hi ha errors mitjançant una expressió regular;<br>19 - Descartar sense canvis;<br>20 - Descartar sense canvis amb un heartbeat;<br>21 - JavaScript;<br>22 - Patró de Prometheus;<br>23 - Prometheus a JSON;<br>24 - CSV a JSON;<br> 25 - Substituïu;<br> >26 - No s'admet la verificació;<br>27 - XML ​​​​a JSON;<br>28 - Valor SNMP walk;<br>29 - SNMP walk a JSON.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|params|string|Paràmetres addicionals emprats per l'opció de preprocessament. Diversos paràmetres són separats pel caràcter LF (\\n).|
|error\_handler|integer|Tipus d'acció que s'empra quan falla el pas de preprocessament.<br><br>Valors possibles:<br>0 - Zabbix defineix el missatge d'error del missatge;< br>1 - Elimina el valor;<br>2 - Estableix un valor personalitzat;<br>3 - Estableix un missatge d'error personalitzat.<br><br>Valors possibles si `type` és "Validar no suportat":<br>1 - Descartar el valor;<br>2 - Establir valor personalitzat;<br>3 - Establir missatge d'error personalitzat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "Multiplicador personalitzat" (1), "Coincidència d'expressió regular" (5), "Booleà a decimal" (6), "Octal a decimal" (7), "Hexadecimal a decimal" (8), "Canvi simple" (9), "Canvi per segon" (10), "XML XPath" (11), "JSONPath" (12), "En rang" (13), "Coincideix amb expressió regular" (14), "No coincideix amb expressió regular" (15), "Verificar errors a JSON" (16), "Verificar errors a  XML" (17), "Verificar errors emprant una expressió regular" (18), "Patró Prometheus" (22), "Prometheus a JSON" (23), "CSV a JSON" (24), "Verificació no admesa" (26), "XML a JSON" (27), "Valor SNMP walk" (28), or "SNMP walk a JSON" (29)|
|error\_handler\_params|string|Paràmetres del gestor d'errors.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `error_handler` és "Establir valor personalitzat" o "Establir missatge d'error personalitzat"|

Els següents paràmetres i gestors d'errors són compatibles per a cada tipus de preprocessament.

|Tipus de preprocessament|Nom|Paràmetre 1|Paràmetre 2|Paràmetre 3|Gestors d'errors admesos|
|------------------|----|------------|-----------|-- ---------|---------|
|1|Multiplicador personalitzat|nombre^1,\6^|<|<|0, 1, 2, 3|
|2|Retalla a la dreta|llista de caràcters^2^|<|<|<|
|3|Retalla a l'esquerra|llista de caràcters^2^|<|<|<|
|4|Retalla|llista de caràcters^2^|<|<|<|
|5|Expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3|
|6|Booleà a decimal|<|<|<|0, 1, 2, 3|
|7|Octal a decimal|<|<|<|0, 1, 2, 3|
|8|Hexadecimal a decimal|<|<|<|0, 1, 2, 3|
|9|Canvi únic|<|<|<|0, 1, 2, 3|
|10|Canvi per segon|<|<|<|0, 1, 2, 3|
|11|XML XPath|camí^4^|<|<|0, 1, 2, 3|
|12|JSONPath|camí^4^|<|<|0, 1, 2, 3|
|13|Dins de l'interval|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3|
|14|Coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3|
|15|No coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3|
|16|Comprova l'error a JSON|camí^4^|<|<|0, 1, 2, 3|
|17|Comprova l'error en XML|camí^4^|<|<|0, 1, 2, 3|
|18|Comprova si hi ha errors emprant l'expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3|
|19|Descarta el que no ha canviat|<|<|<|<|
|20|Descarta el no canviat amb un heartbeat|segons^5,\ 6^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|22|Patró de Prometheus|patró^6,\7^|`valor`, `etiqueta`, `funció`|sortida^8,\9^|0, 1, 2, 3|
|23|Prometheus a JSON|patró^6,\7^|<|<|0, 1, 2, 3|
|24|CSV a JSON|char^2^|char^2^|0,1|0, 1, 2, 3|
|25|Substitueix|cadena de cerca^2^|substitueix^2^|<|<|
|26|La verificació no és compatible|<|<|<|1, 2, 3|
|27|XML a JSON|<|<|<|0, 1, 2, 3|
|28|Valor SNMP walk|OID^2^|Format:<br>0 - No canviat<br>1 - UTF-8 de Hex-STRING<br>2 - MAC de Hex-STRING<br>3 - Enter de BITS|<|0, 1, 2, 3|
|29|SNMP walk a JSON^10^|Field name^2^|OID prefix^2^|Format:<br>0 - No canviat<br>1 - UTF-8 de Hex-STRING<br>2 - MAC de Hex-STRING<br>3 - Enter de BITS|0, 1, 2, 3|

^1^ nombre enter o coma flotant\
^2^ cadena\
^3^ expressió regular\
^4^ JSONPath o XML XPath\
^5^ enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)\
^6^ macro d'usuari\
^7^ El model de Prometheus segueix la sintaxi: `<nom mètric>{<nom de l'etiqueta>="<valor de l'etiqueta>", ...} == <valor>`. Cada component del patró de Prometheus (mètrica, nom d'etiqueta, valor d'etiqueta i valor de mètrica) pot ser una macro d'usuari.
^8^ Prometheus mostra la següent sintaxi: `<nom de l'etiqueta>` (pot ser una macro d'usuari) si `etiqueta` està seleccionada com a segon paràmetre.\
^9^ Una de les funcions agregades: `sum`, `min`, `max`, `avg`, `count` si `function` està seleccionat com a segon paràmetre.
^10^ Admet diversos "Nom de camp,prefix OID,Registre de format" registres separtas per un caràcter de nova línia.

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