[comment]: # translation:outdated
[comment]: # aside:1
[comment]: # ({9103dc79-8098e93a})
# Objecte de prototip de regla LLD
Els següents objectes són relacionats amb l'API `discoveryruleprototype`.
[comment]: # ({/9103dc79-8098e93a})
[comment]: # ({763909aa-0c810d05})
### Prototip de regla LLD
L'objecte prototip de regla de descoberta de baix nivell té les propietats següents.
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|itemid|ID|ID del prototip de regla LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *només lectura*
- *obligatori* per a les operacions d'actualització|
|ruleid|ID|ID de la regla LLD principal/prototip de regla LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *només lectura*
- *obligatori* per a les operacions de creació|
|delay|string|Interval d'actualització del prototip de regla LLD.
Accepta segons o unitats de temps amb sufix (per exemple, 30s, 1m, 2h, 1d) i, opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals), tots separats per punts i coma. Els intervals personalitzats poden ser una barreja d'intervals flexibles i de programació.
Accepta macros d'usuari. Si s'utilitza, el valor ha de ser una sola macro. No s'admeten diverses macros ni macros barrejades amb text. Els intervals flexibles es poden escriure com a dues macros separades per una barra inclinada (per exemple, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).
Exemple:
`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `type` és definit a "Agent Zabbix" (0), "Comprovació simple" (3), "Zabbix intern" (5), "Comprovació externa" (10), "Monitoratge de base de dades" (11), "Agent IPMI" (12), "Agent SSH" (13), "Agent TELNET" (14), "JMX agent" (16), "Agent HTTP" (19), "Agent SNMP" (20), "Script" (21), "Navegador" (22), o si `type` és definit a "Agent Zabbix (actiu)" (7) i `key_` no conté "mqtt.get"|
|hostid|ID|ID de l'equip al qual pertany el prototip de regla LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *constant*
- *obligatori* per a les operacions de creació|
|iddd|ID|ID de la interfície d'equip del prototip de regla LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si el prototip de regla LLD pertany a l'equip i `type` és definit a "Agent Zabbix", "Agent IPMI", "Agent JMX" o "Agent SNMP"
- *compatible* si el prototip de regla LLD pertany a l'equip i `type` és definit a "Comprovació simple", "Comprovació externa", "Agent SSH", "Agent TELNET" o "Agent HTTP"|
|clau\_|cadena|Clau del prototip de regla LLD. Cal com a mínim una macro LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* per a les operacions de creació
- *només lectura* per als objectes heretats|
|nom|cadena|Nom del prototip de regla LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* per a les operacions de creació
- *només lectura* per als objectes heretats|
|tipus|enter|Tipus del prototip de regla LLD.
Valors possibles:
0 - Agent Zabbix;
2 - Trapper Zabbix;
3 - Comprovació simple;
5 - Zabbix intern;
7 - Agent Zabbix (actiu);
10 - Comprovació externa;
11 - Monitoratge de base de dades;
12 - Agent IPMI;
13 - Agent SSH;
14 - Agent TELNET;
16 - Agent JMX;
18 - Element dependent;
19 - Agent HTTP;
20 - Agent SNMP;
21 - Script;
22 - Navegador;
23 - Heretat.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* per a les operacions de creació
- *només lectura* per als objectes heretats|
|url|cadena|Cadena d'URL.
Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `type` és definit a "Agent HTTP"
- *només lectura* per a objectes heretats|
|allow\_traps|integer|Permet omplir el valor de manera similar a l'element trapper.
Valors possibles:
0 - *(per defecte)* No permet acceptar dades entrants;
1 - Permet acceptar dades entrants.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *admès* si `type` és definit a "Agent HTTP"| |authtype|enter|Mètode d'autenticació.
Valors possibles si `type` és definit a "Agent SSH":
0 - *(per defecte)* contrasenya;
1 - clau pública.
Valors possibles si `type` és definit a "Agent HTTP":
0 - *(per defecte)* cap;
1 - bàsic;
2 - NTLM.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *compatible* si `type` és definit a "Agent SSH" o "Agent HTTP"
- *només lectura* per a objectes heretats (si `type` és definit a "Agent HTTP")|
|descripció|cadena|Descripció del prototip de regla LLD.|
|error|cadena|Text d'error si hi ha problemes en actualitzar el valor del prototip de la regla LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *només lectura*|
|follow\_redirects|nombre enter|Segueix les redireccions de resposta mentre s'enquesten les dades.
Valors possibles:
0 - No segueix les redireccions;
1 - *(per defecte)* Segueix les redireccions.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *admès* si `type` és definit a "Agent HTTP"
- *només lectura* per a objectes heretats|
|capçaleres|matriu|Matriu de [capçaleres](#http-header) que s'enviarà en realitzar una petició HTTP.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *compatible* si `type` és definit a "Agent HTTP"
- *només lectura* per a objectes heretats|
|http\_proxy|cadena|Cadena de connexió del proxy HTTP(S).
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *compatible* si `type` és definit a "Agent HTTP"
- *només lectura* per a objectes heretats|
|ipmi\_sensor|cadena|Sensor IPMI.
[Propietat comportament](/manual/api/reference_commentary#property-behavior):
- *requerit* si `type` és definit a "IPMI agent" i `key_` no és definit a "ipmi.get"
- *suportat* si `type` és definit a "IPMI agent"
- *només lectura* per a objectes heretats|
|jmx\_endpoint|cadena|Cadena de connexió personalitzada de l'agent JMX.
Per defecte: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *suportat* si `type` és definit a "JMX agent"|
|durada|cadena|Període de temps després del qual s'esborraran els elements que ja no es troben. Accepta segons, unitat de temps amb sufix o un usuari macro.
Per defecte: `7d`.|
|lifetime\_type|integer|Escenari per esborrar els recursos LLD perduts.
Valors possibles:
0 - *(per defecte)* Esborra després d'arribar al llindar de vida útil;
1 - No esborrar;
2 - Esborrar de cop.|
|enabled\_lifetime|string|Període de temps després del qual els elements que ja no es troben es desactivaran. Accepta segons, unitat de temps amb sufix o una macro d'usuari.
Per defecte: `0`.|
|enabled\_lifetime\_type|integer|Escenari per desactivar els recursos LLD perduts.
Valors possibles:
0 - Desactiva després d'arribar al llindar de vida útil;
1 - No desactivar;
2 - *(per defecte)* Desactiva immediatament.|
|master\_itemid|ID|ID de l'element mestre.
La regla de descoberta no pot ser l'element mestre per a una altra regla de descoberta.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *requerit* si `type` és definit a "Element dependent"
- *només lectura* per a objectes heretats|
|output\_format|enter|La resposta s'ha de convertir a JSON.
Valors possibles:
0 - *(per defecte)* Emmagatzemar en brut;
1 - Convertir a JSON.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *suportat* si `type` és definit a "agent HTTP"
- *només lectura* per a objectes heretats|
|params|string|Paràmetres addicionals segons el tipus del prototip de regla LLD:
- script executat per a regles LLD SSH i Telnet;
- consulta SQL per a regles LLD del monitor de bases de dades;
- fórmula per a regles LLD calculades;
- l'script per a regles LLD d'script i navegador.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `type` és definit a "Monitor de base de dades", "Agent SSH", "Agent TELNET", "Script" o "Navegador"
- *només lectura* per a objectes heretats (si `type` és definit a "Script" o "Navegador")|
|paràmetres|objecte/matriu|Paràmetres addicionals si `type` és definit a "Script" o "Navegador".
Matriu d'objectes amb les propietats `name` i `value`, on `name` ha de ser únic.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *admès* si `type` és definit a "Script" o "Navegador"
- *només lectura* per a objectes heretats|
|mot de pas|cadena|Mot de pas per a l'autenticació.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `type` és definit a "Agent JMX" i `nom d'usuari` és definit
- *admès* si `type` és definit a "Comprovació simple", "Monitoratge de base de dades", "Agent SSH", "Agent TELNET" o "Agent HTTP"
- *només lectura* per a objectes heretats (si `type` és definit a "Agent HTTP")|
|post\_type|nombre enter|Tipus de cos de dades de la publicació emmagatzemat a la propietat `posts`.
Valors possibles:
0 - *(per defecte)* Dades en brut;
2 - Dades JSON;
3 - Dades XML.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *admès* si `type` és definit a "Agent HTTP"
- *només lectura* per a objectes heretats|
|publicacions|cadena|Dades del cos de la petició HTTP(S).
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *requerit* si `type` és definit a "Agent HTTP" i `post_type` és definit a "dades JSON" o "dades XML"
- *admès* si `type` és definit a "Agent HTTP" i `post_type` és definit a "Dades en brut"
- *només lectura* per a objectes heretats|
|clave privada|cadena|Nom del fitxer de clau privada.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *requerit* si `type` és definit a "Agent SSH" i `authtype` és definit a "public clau"|
|clau_publica|cadena|Nom del fitxer de clau pública.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `type` és definit a "agent SSH" i `authtype` és definit a "clau_publica"|
|camps_de_consulta|matriu|Matriu de [camps de consulta](#camp_de_consulta_http) que s'enviarà en realitzar una petició HTTP.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *compatible* si `type` és definit a "agent HTTP"
- *només lectura* per a objectes heretats|
|request\_method|nombre enter|Tipus de mètode de sol·licitud.
Valors possibles:
0 - *(per defecte)* GET;
1 - POST;
2 - PUT;
3 - HEAD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *compatible* si `type` és definit a "agent HTTP"
- *només lectura* per a objectes heretats|
|retrieve\_mode|integer|Quina part de la resposta s'ha d'emmagatzemar.
Valors possibles si `request_method` és definit a "GET", "POST" o "PUT":
0 - *(per defecte)* Cos;
1 - Capçaleres;
2 - S'emmagatzemaran tant el cos com les capçaleres.
Valors possibles si `request_method` és definit a "HEAD":
1 - Capçaleres.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *compatible* si `type` és definit a "agent HTTP"
- *només lectura* per a objectes heretats|
|snmp\_oid|cadena|OID SNMP.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `type` és definit a "agent SNMP"
- *només lectura* per a objectes heretats|
|ssl\_cert\_file|cadena|Ruta del fitxer de clau SSL pública.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *admès* si `type` és definit a "agent HTTP"
- *només lectura* per a objectes heretats|
|ssl\_key\_file|string|Ruta del fitxer de clau SSL privada.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *compatible* si `type` és definit a "Agent HTTP"
- *només lectura* per a objectes heretats|
|ssl\_key\_password|string|Contrasenya per al fitxer de clau SSL.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *compatible* si `type` és definit a "Agent HTTP"
- *només lectura* per a objectes heretats|
|estat|nombre enter|Estat del prototip de regla LLD.
Valors possibles:
0 - *(per defecte)* normal;
1 - no compatible.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *només lectura*|
|estat|nombre enter|Estat del prototip de regla LLD.
Valors possibles:
0 - *(per defecte)* prototip de regla LLD habilitat;
1 - prototip de regla LLD deshabilitat.|
|estat\_codes|cadena|Intervals de codis d'estat HTTP obligatoris, separats per comes. També admet macros d'usuari com a part de la llista separada per comes.
Exemple: 200,200-{$M},{$M},200-400
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *admès* si `type` és definit a "Agent HTTP"
- *només lectura* per a objectes heretats|
|templateid|ID|ID del prototip de regla LLD de la plantilla principal.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *només lectura*|
|timeout|string|Temps d'espera de la petició de sondeig de dades d'element.
Admet segons o unitats de temps amb sufix (per exemple, 30s, 1m). També admet macros d'usuari.
Rang de valors possibles: 1-600s.
Valor per defecte: "" - utilitza la configuració proxy/global.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *compatible* si `type` és definit a "Agent Zabbix" (0), "Comprovació simple" (3) i `key_` no comença amb "`vmware.`" i "`icmpping`", "Agent Zabbix (actiu)" (7), "Comprovació externa" (10), "Monitoratge de base de dades" (11), "Agent SSH" (13), "Agent TELNET" (14), "Agent HTTP" (19), "Agent SNMP" (20) i `snmp_oid` comença amb "`walk[`" o "`get[`", "Script" (21), "Navegador" (22)
- *només lectura* per a objectes heretats|
|trapper\_hosts|cadena|Amfitrions permesos.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *admès* si `type` és definit a "Zabbix trapper", o si `type` és definit a "HTTP agent" i `allow_traps` és definit a "Permetre acceptar dades entrants"|
|nom d'usuari|cadena|Nom d'usuari per a l'autenticació.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `type` és definit a "Agent SSH", "Agent TELNET" o si `type` és definit a "Agent JMX" i `password` està definit
- *admès* si `type` és definit a "Comprovació simple", "Monitoratge de base de dades" o "Agent HTTP"
- *només lectura* per a objectes heretats (si `type` és definit a "Agent HTTP")|
|uuid|cadena|Identificador únic universal, utilitzat per enllaçar prototips de regles LLD importats amb els ja existents. Generat automàticament, si no es proporciona.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *admès* si el prototip de regle LLD pertany a una plantilla|
|verify\_host|integer|Si cal validar que el nom de l'equip per a la connexió coincideixi amb el del certificat de l'equip.
Valors possibles:
0 - *(per defecte)* No validar;
1 - Validar.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *suportat* si `type` és definit a "Agent HTTP"
- *només lectura* per a objectes heretats|
|verify\_peer|integer|Si cal validar que el certificat de l'equip és autèntic.
Valors possibles:
0 - *(per defecte)* No validar;
1 - Validar.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *suportat* si `type` es defineix a "agent HTTP"
- *només lectura* per a objectes heretats|
[comment]: # ({/763909aa-0c810d05})
[comment]: # ({d2292082-caf82a93})
#### Capçalera HTTP
L'objecte de capçalera té les propietats següents:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--------|----------------------------------------- -----------|-----------|
|nom|string|Nom de la capçalera HTTP.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
|valor|string|Valor de la capçalera.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/d2292082-caf82a93})
[comment]: # ({f8bb0738-0c63a63b})
#### Camp de consulta HTTP
L'objecte del camp de consulta defineix un nom i un valor que s'empra per especificar un paràmetre d'URL.
Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--------|----------------------------------------- -----------|-----------|
|nom|string|Nom del paràmetre.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
|valor|string|Valor del paràmetre.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/f8bb0738-0c63a63b})
[comment]: # ({e12e802b-bc5ce0af})
### Filtre de prototip de regla LLD
L'objecte de filtre de prototip de regla LLD defineix un conjunt de condicions que es poden emprar
per filtrar objectes trobats. Té les propietats següents:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|condicions|objecte/matriu|Conjunt de [condicions de filtre](#lld-rule-prototype-filter-condition) per utilitzar per filtrar resultats. Les condicions s'ordenaran segons la seva ubicació a la fórmula.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required*|
|evaltype|nombre enter|[Mètode d'avaluació](/manual/discovery/low_level_discovery#filter) de la condició del filtre.
Valors possibles:
0 - i/o;
1 - i;
2 - o;
3 - expressió personalitzada.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required*|
|eval\_formula|string|Expressió generada que s'utilitzarà per avaluar les condicions del filtre. L'expressió conté identificadors que fan referència a condicions de filtre específiques mitjançant el seu `formulaid`. El valor de `eval_formula` és igual al valor de `formula` per als filtres amb una expressió personalitzada.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *només lectura*|
|formula|string|Expressió definida per l'usuari que s'utilitzarà per avaluar les condicions dels filtres amb una expressió personalitzada. L'expressió ha de contenir identificadors que facin referència a condicions de filtre específiques mitjançant el seu `formulaid`. Els identificadors utilitzats a l'expressió han de coincidir exactament amb els definits a les condicions de filtre: cap condició pot romandre sense utilitzar o omesa.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `evaltype` està definit com a "expressió personalitzada"|
[comment]: # ({/e12e802b-bc5ce0af})
[comment]: # ({4b223481-5bd71a86})
#### Condició de filtre de prototip de regla LLD
L'objecte de condició de filtre de prototip de regla LLD defineix una comprovació independent per realitzar
sobre el valor d'una macro LLD. Té les propietats següents:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|macro|cadena|Macro LLD per realitzar la comprovació.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required*|
|valor|cadena|Valor amb què comparar.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required* si `operator` és definit com a "coincideix amb l'expressió regular" o "no coincideix amb l'expressió regular"|
|formulaid|string|ID únic arbitrari que s'utilitza per fer referència a la condició des d'una expressió personalitzada. Només pot contindre majúscules. L'usuari ha de definir l'ID en modificar les condicions del filtre, però es generarà de nou en demanar-les posteriorment.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required* if `evaltype` of [LLD rule prototype filter object](#lld-rule-prototype-filter) is set a "custom expression"|
|operator|integer|Operador de condició.
Valors possibles:
8 - *(per defecte)* coincideix amb l'expressió regular;
9 - no coincideix amb l'expressió regular;
12 - existeix;
13 - no existeix.|
::: notetip
Per entendre millor com utilitzar filtres amb diversos
tipus d'expressions, veieu exemples a les pàgines del mètode
[discoveryruleprototype.get](get#retrieving_filter_conditions) i
[discoveryruleprototype.create](create#using_a_custom_expression_filter).
:::
[comment]: # ({/4b223481-5bd71a86})
[comment]: # ({4694ea00-ec3a36b7})
### Ruta de macro LLD
La ruta de la macro LLD té les propietats següents:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|lld\_macro|cadena|Macro LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
|path|cadena|Selector de valor que serà assignat a la macro corresponent.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/4694ea00-ec3a36b7})
[comment]: # ({97c37807-e8aecce9})
### Preprocessament del prototip de regla LLD
L'objecte de preprocessament del prototip de regla LLD té les propietats següents.
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|tipus|enter|El tipus d'opció de preprocessament.
Valors possibles:
5 - Expressió regular;
11 - XML XPath;
12 - JSONPath;
14 - Coincideix amb l'expressió regular;
15 - No coincideix amb l'expressió regular;
16 - Comprova si hi ha errors a JSON;
17 - Comprova si hi ha errors a XML;
20 - Descarta sense canvis amb el batec del cor;
21 - JavaScript;
23 - De Prometheus a JSON;
24 - De CSV a JSON;
25 - Reemplaça;
27 - De XML a JSON;
28 - Valor de recorregut SNMP;
29 - Recorregut SNMP a JSON;
30 - Valor d'obtenció SNMP.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required*|
|params|string|Paràmetres addicionals utilitzats per l'opció de preprocessament. Els diversos paràmetres estan separats pel caràcter de salt de línia (\\n).
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `type` està definit com a "Expressió regular" (5), "XML XPath" (11), "JSONPath" (12), "Coincideix amb l'expressió regular" (14), "No coincideix amb l'expressió regular" (15), "Comprova si hi ha errors a JSON" (16), "Comprova si hi ha errors a XML" (17), "Descarta sense canvis amb un batec del cor" (20), "JavaScript" (21), "De Prometeu a JSON" (23), "De CSV a JSON" (24), "Substitueix" (25), "Valor de recorregut SNMP" (28), "Caminament SNMP a JSON" (29) o "Valor d'obtenció SNMP" (30)|
|error\_handler|enter|Tipus d'acció utilitzat en cas d'error del pas de preprocessament.
Valors possibles:
0 - El missatge d'error el defineix el servidor Zabbix;
1 - Descarta el valor;
2 - Defineix un valor personalitzat;
3 - Defineix un missatge d'error personalitzat.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `type` està definit com a "Expressió regular" (5), "XML XPath" (11), "JSONPath" (12), "Coincideix amb l'expressió regular" (14), "No coincideix amb l'expressió regular" (15), "Comprova si hi ha errors a JSON" (16), "Comprova si hi ha errors a XML" (17), "Prometeu a JSON" (23), "CSV a JSON" (24), "XML a JSON" (27), "Valor de recorregut SNMP" (28), "SNMP "caminar fins a JSON" (29) o "SNMP obtenir valor" (30)|
|error\_handler\_params|cadena|Paràmetres del gestor d'errors.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `error_handler` està definit com a "Defineix valor personalitzat" o "Defineix missatge d'error personalitzat"|
Els paràmetres i gestors d'errors següents són compatibles amb cada tipus de preprocessament.
|Tipus de preprocessament|Nom|Paràmetre 1|Paràmetre 2|Paràmetre 3|Gestors d'errors compatibles|
|------------------|----|----------|-----------|-----------|-----------|------------------------|
|5|Expressió regular|patró^1^|sortida^2^|<|0, 1, 2, 3|
|11|XML XPath|camí^3^|<|<|0, 1, 2, 3|
|12|JSONPath|camí^3^|<|<|0, 1, 2, 3|
|14|Coincideix amb l'expressió regular|pattern^1^|<|<|0, 1, 2, 3|
|15|No coincideix amb l'expressió regular|pattern^1^|<|<|0, 1, 2, 3|
|16|Comprova si hi ha errors a JSON|camí^3^|<|<|0, 1, 2, 3|
|17|Comprova si hi ha errors a XML|camí^3^|<|<|0, 1, 2, 3|
|20|Descarta sense canvis amb el batec del cor|segons^4,\ 5^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|23|Prometeu a JSON|patró^5,\ 6^|<|<|0, 1, 2, 3|
|24|CSV a JSON|caràcter^2^|caràcter^2^|0,1|0, 1, 2, 3|
|25|Substitueix|cadena de cerca^2^|substitució^2^|<|<|
|27|XML a JSON|<|<|<|0, 1, 2, 3|
|28|Valor de recorregut SNMP|OID^2^|Format:
0 - Sense canvis
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Enter de BITS|<|0, 1, 2, 3|
|29|Caminada SNMP a JSON^7^|Nom del camp^2^|Prefix OID^2^|Format:
0 - Sense canvis
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Enter de BITS|0, 1, 2, 3|
|30|Obtén valor SNMP|Format:
1 - UTF-8 de Hex-STRING
2 - MAC de Hex-STRING
3 - Enter de BITS|<|<|0, 1, 2, 3|
^1^ expressió regular\
^2^ cadena\
^3^ JSONPath o XML XPath\
^4^ enter positiu (amb suport per a sufixos de temps, p. ex. 30s, 1m, 2h,
1d)\
^5^ macro d'usuari\
^6^ Patró Prometheus que segueix la sintaxi:
`{="", ...} == `. Cada
component del patró Prometheus (mètrica, nom de l'etiqueta, valor de l'etiqueta i valor de la mètrica) pot ser una macro d'usuari.\
^7^ Admet diversos registres de "Nom de camp, prefix OID, format de registres" delimitats per un caràcter de nova línia.
[comment]: # ({/97c37807-e8aecce9})
[comment]: # ({c5ee2b5f-e4056f02})
### Sobrecàrrega de prototip de regles LLD
L'objecte de sobrecàrrega de prototip de regles LLD defineix un conjunt de regles (filtres, condicions i operacions) que s'empren per anul·lar les propietats de diversos objectes prototip. Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|nom|string|Nom únic de sobrecàrrega.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
|passa|integer|Nombre de seqüència únic de la sobrecàrrega.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
|stop|integer|Atura el processament de les sobrecàrregues futures si coincideix.
Valors possibles:
0 - *(per defecte)* no atura el processament de les sobrecàrregues;
1: atura el processament de les sobrecàrregues del procés si el filtre coincideix .|
|filtre|object|Filtre de sobrecàrrega.|
|operacions|object/array|Operacions de sobrecàrrega.|
:::
[comment]: # ({/c5ee2b5f-e4056f02})
[comment]: # ({4e1e5b7b-eb1755ad})
#### Filtre de substitució de prototip de regla LLD
L'objecte de filtre de substitució de prototip de regla LLD defineix un conjunt de condicions que, si coincideixen amb l'objecte trobat, s'aplica la substitució. Té les propietats següents:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|-----|
|conditions|object/array|Conjunt de [condicions de filtre de substitució](#lld-rule-prototype-override-filter-condition) que s'utilitzaran per fer coincidir els objectes trobats. Les condicions s'ordenaran segons la seva ubicació a la fórmula.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required*|
|evaltype|integer|[Mètode d'avaluació](/manual/discovery/low_level_discovery#override) de la condició del filtre de substitució.
Valors possibles:
0 - i/o;
1 - i;
2 - o;
3 - expressió personalitzada.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required*|
|eval\_formula|string|Expressió generada que s'utilitzarà per avaluar les condicions del filtre de substitució. L'expressió conté identificadors que fan referència a condicions específiques del filtre de substitució mitjançant el seu `formulaid`. El valor de `eval_formula` és igual al valor de `formula` per als filtres amb una expressió personalitzada.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|formula|string|Expressió definida per l'usuari que s'utilitzarà per avaluar les condicions dels filtres de substitució amb una expressió personalitzada. L'expressió ha de contenir identificadors que facin referència a condicions de filtre de substitució específiques mitjançant el seu `formulaid`. Els identificadors utilitzats a l'expressió han de coincidir exactament amb els definits a les condicions de filtre de substitució: cap condició pot romandre sense utilitzar o omesa.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `evaltype` està definit com a "expressió personalitzada"|
[comment]: # ({/4e1e5b7b-eb1755ad})
[comment]: # ({c36b7339-78df0c99})
##### Condició de filtre de substitució del prototip de regla LLD
L'objecte de condició de filtre de substitució del prototip de regla LLD defineix una comprovació separada
per dur a terme sobre el valor d'una macro LLD. Té les propietats següents:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|macro|cadena|Macro LLD per realitzar la comprovació.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required*|
|valor|cadena|Valor amb què comparar.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required* si `operator` està definit com a "coincideix amb l'expressió regular" o "no coincideix amb l'expressió regular"|
|formulaid|string|ID únic arbitrari que s'utilitza per fer referència a la condició des d'una expressió personalitzada. Només pot contindre majúscules. L'usuari ha de definir l'ID en modificar les condicions del filtre, però es generarà de nou en demanar-les posteriorment.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori* si `evaltype` de [objecte de filtre de substitució de prototip de regla LLD](#lld-rule-prototype-override-filter) està definit com a "expressió personalitzada"|
|operator|enter|Operador de condició.
Valors possibles:
8 - *(per defecte)* coincideix amb l'expressió regular;
9 - no coincideix amb l'expressió regular;
12 - existeix;
13 - no existeix.|
[comment]: # ({/c36b7339-78df0c99})
[comment]: # ({2d45e14b-f48571a7})
#### Operació de substitució del prototip de regla LLD
L'operació de substitució del prototip de regla LLD és una combinació de condicions i accions
que es realitzaran sobre l'objecte prototip. Té les propietats següents:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|-----|
|operationobject|enter|Tipus d'objecte descobert per fer l'acció.
Valors possibles:
0 - Prototip d'element;
1 - Prototip de desencadenant;
2 - Prototip de gràfic;
3 - Prototip d'equip.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *required*|
|operador|enter|[Operador](/manual/discovery/low_level_discovery#discovery-rule) de condició de sobreescriptura.
Valors possibles:
0 - *(per defecte)* és igual a;
1 - no és igual a;
2 - conté;
3 - no conté;
8 - coincideix;
9 - no coincideix.|
|valor|cadena|Patró per coincidir amb el nom de l'element, disparador, gràfic o prototip d'equip segons l'objecte seleccionat.|
|opstatus|object|Objecte d'estat de l'operació de sobreescriptura per a objectes d'element, disparador i prototip d'equip.|
|opdiscover|object|Objecte d'estat de descobriment de l'operació de sobreescriptura (tots els tipus d'objectes).|
|operiod|object|Objecte de període d'operació de sobreescriptura (interval d'actualització) per a l'objecte prototip d'element.|
|ophistory|object|Objecte d'historial d'operacions de sobreescriptura per a l'objecte prototip d'element.|
|optrends|object|Objecte de tendències d'operacions de sobreescriptura per a l'objecte prototip d'element.|
|opseverity|object|Objecte de gravetat de l'operació de sobreescriptura per a l'objecte prototip d'element.|
|optag|object/array|Subscriu l'objecte d'etiqueta d'operació per a objectes de prototipus d'equip i de desencadenant.|
|optemplate|object/array|Subscriu l'objecte de plantilla d'operació per a l'objecte de prototipus d'equip.|
|opinventory|object|Subscriu l'objecte d'inventari d'operacions per a l'objecte de prototipus d'equip.|
[comment]: # ({/2d45e14b-f48571a7})
[comment]: # ({843573ab-3b334927})
##### Estat de l'operació de sobrecàrrega del prototip de regla LLD
Estat de l'operació de sobrecàrrega del prototip de regla LLD que s'estableix com a objecte trobat. Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|status|enter|Anul·la l'estat de l'objecte seleccionat.
Valors possibles:
0 - Creació activada;
1 - Creació desactivada.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/843573ab-3b334927})
[comment]: # ({9307a30f-1d3a7323})
##### Operació de sobrecàrrega de descoberta de prototip de regles LLD
Estat de l'operació de sobrecàrrega de descoberta de prototip de regla LLD que s'estableix a l'objecte trobat. Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|discover|enter|Anul·la l'estat de descoberta de l'objecte triat.
Valors possibles:
0 - Sí, continuar cercant objectes;< br>1 - No , els elements nous no es trobaran pas i els elements existents es marcaran com a perduts.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/9307a30f-1d3a7323})
[comment]: # ({ab933ce3-68053e07})
##### Període d'operació de substitució del prototip de regla LLD
El període d'operació de substitució del prototip de regla LLD és un valor d'interval d'actualització que s'estableix a l'element trobat.
Té les propietats següents:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|-----|
|delay|string|Substitueix l'interval d'actualització del prototip de l'element.
Accepta segons o unitats de temps amb sufix (per exemple, 30s, 1m, 2h, 1d) i, opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals), tots separats per punts i coma. Els intervals personalitzats poden ser una barreja d'intervals flexibles i de programació.
Accepta macros d'usuari o macros LLD. Si s'utilitza, el valor ha de ser una única macro. No s'admeten diverses macros o macros barrejades amb text. Els intervals flexibles es poden escriure com a dues macros separades per una barra inclinada (per exemple, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).
Exemple:
`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/ab933ce3-68053e07})
[comment]: # ({da698f3a-b2c95fc0})
##### Operació de sobrecàrrega de l'historial de prototip de regles LLD
Operació de sobrecàrrega de l'historial de prototip de regles LLD establerta a l'element trobat. Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|historial|cadena|Substitueix l'històtic del prototip d'element, que és una unitat de temps de quant de temps s'han d'emmagatzemar les dades de l'històric. També accepta macro d'usuari i macro LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/da698f3a-b2c95fc0})
[comment]: # ({249ff76a-5f38e1de})
##### Operació de sobrecàrrega de les tendències de prototip de regles LLD
Operació de sobrecàrrega de les tendències de prototip de regles LLD establerta a l'element trobat. Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|tendències|cadena|Substitueix les tendències del prototip d'element, que és una unitat de temps de quant de temps s'han d'emmagatzemar les dades de les tendències. També accepta macro d'usuari i macro LLD.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/249ff76a-5f38e1de})
[comment]: # ({4545cad2-56d24096})
##### Operació de sobrecàrrega de gravetat de prototip de regla LLD
L'operació s'ha establert al trigger trobat. Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|severity|enter|Anul·la la gravetat del prototip de trigger.
Valors possibles:
0 - *(per defecte)* sense classificar;
1 - informació ;
2 - avís;
3 - mitjana;
4 - alta;
5 - desastre.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/4545cad2-56d24096})
[comment]: # ({4337e818-60427262})
##### Operació de sobrecàrrega d'etiquetes de prototip de regla LLD
L'operació conté el nom i el valor de l'etiqueta definit a l'objecte trobat. Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|tag|cadena|Nom d'etiqueta nou.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
|value|cadena|Valor d'etiqueta nou.|
[comment]: # ({/4337e818-60427262})
[comment]: # ({041af97a-4734353e})
##### Operació de sobrecàrrega del model de prototip de regles LLD
Objecte d'operació de sobrecàrrega del model vinculat a l'equip trobat. Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|templateid|ID|Substitueix la plantilla de les plantilles vinculades al prototip de l'equip.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/041af97a-4734353e})
[comment]: # ({27378ad0-207a5109})
##### Operació de sobrecàrrega d'inventari de prototip de regles LLD
Operació per anul·lar el valor del mode d'inventari del prototip de regla LLD que s'estableix a l'equip trobat. Té les següents propietats:
|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|inventory\_mode|enter|Ignora el mode d'inventari del prototip de l'equip.
Valors possibles:
-1 - desactivat;< br>0 - *( per defecte)* manual;
1 - automàtic.
[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):
- *obligatori*|
[comment]: # ({/27378ad0-207a5109})