[comment]: # aside: 1

[comment]: # ({3bf923db-c5a9e121})
# Oggetto regola LLD

I seguenti oggetti sono direttamente correlati all'API `discoveryrule`.

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

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

L'oggetto della regola di discovery a basso livello ha le seguenti proprietà.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID della regola LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* per le operazioni di aggiornamento|
|delay|string|Intervallo di aggiornamento della regola LLD.<br><br>Accetta secondi o un'unità di tempo con suffisso (ad esempio, 30s, 1m, 2h, 1d) e, facoltativamente, uno o più [intervalli personalizzati](/manual/config/items/item/custom_intervals), tutti separati da punto e virgola. Gli intervalli personalizzati possono essere una combinazione di intervalli flessibili e di pianificazione.<br><br>Accetta macro utente. Se utilizzato, il valore deve essere una singola macro. Non sono supportate più macro né macro combinate con testo. Gli intervalli flessibili possono essere scritti come due macro separate da una barra obliqua (ad esempio, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Esempio:<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* se `type` è impostato su "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), oppure se `type` è impostato su "Zabbix agent (active)" (7) e `key_` non contiene "mqtt.get"|
|hostid|ID|ID dell'host a cui appartiene la regola LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* per le operazioni di creazione|
|interfaceid|ID|ID dell'interfaccia host della regola LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se la regola LLD appartiene a un host e `type` è impostato su "Zabbix agent", "IPMI agent", "JMX agent" o "SNMP agent"<br>- *supported* se la regola LLD appartiene a un host e `type` è impostato su "Simple check", "External check", "SSH agent", "TELNET agent" o "HTTP agent"|
|key\_|string|Chiave della regola LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* per le operazioni di creazione<br>- *read-only* per gli oggetti ereditati|
|name|string|Nome della regola LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* per le operazioni di creazione<br>- *read-only* per gli oggetti ereditati|
|type|integer|Tipo della regola LLD.<br><br>Valori possibili:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - Simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>16 - JMX agent;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script;<br>22 - Browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* per le operazioni di creazione<br>- *read-only* per gli oggetti ereditati|
|url|string|Stringa URL.<br>Supporta macro utente, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|allow\_traps|integer|Consente di popolare il valore in modo simile all'item trapper.<br><br>Valori possibili:<br>0 - *(default)* Non consentire l'accettazione dei dati in ingresso;<br>1 - Consentire l'accettazione dei dati in ingresso.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"|
|authtype|integer|Metodo di autenticazione.<br><br>Valori possibili se `type` è impostato su "SSH agent":<br>0 - *(default)* password;<br>1 - chiave pubblica.<br><br>Valori possibili se `type` è impostato su "HTTP agent":<br>0 - *(default)* nessuno;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "SSH agent" o "HTTP agent"<br>- *read-only* per gli oggetti ereditati (se `type` è impostato su "HTTP agent")|
|description|string|Descrizione della regola LLD.|
|error|string|Testo di errore se si verificano problemi durante l'aggiornamento del valore della regola LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|follow\_redirects|integer|Segui i redirect della risposta durante il polling dei dati.<br><br>Valori possibili:<br>0 - Non seguire i redirect;<br>1 - *(default)* Seguire i redirect.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|headers|array|Array di [headers](#http-header) che verranno inviati durante l'esecuzione di una richiesta HTTP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|http\_proxy|string|Stringa di connessione del proxy HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|ipmi\_sensor|string|Sensore IPMI.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "IPMI agent" e `key_` non è impostato su "ipmi.get"<br>- *supported* se `type` è impostato su "IPMI agent"<br>- *read-only* per gli oggetti ereditati|
|jmx\_endpoint|string|Stringa di connessione personalizzata dell'agent JMX.<br><br>Predefinito: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "JMX agent"|
|lifetime|string|Periodo di tempo dopo il quale gli item non più scoperti verranno eliminati. Accetta secondi, un'unità di tempo con suffisso o una macro utente.<br><br>Predefinito: `7d`.|
|lifetime\_type|integer|Scenario per eliminare le risorse LLD perse.<br><br>Valori possibili:<br>0 - *(default)* Elimina dopo il raggiungimento della soglia di lifetime;<br>1 - Non eliminare;<br>2 - Elimina immediatamente.|
|enabled\_lifetime|string|Periodo di tempo dopo il quale gli item non più scoperti verranno disabilitati. Accetta secondi, un'unità di tempo con suffisso o una macro utente.<br><br>Predefinito: `0`.|
|enabled\_lifetime\_type|integer|Scenario per disabilitare le risorse LLD perse.<br><br>Valori possibili:<br>0 - Disabilita dopo il raggiungimento della soglia di lifetime;<br>1 - Non disabilitare;<br>2 - *(default)* Disabilita immediatamente.|
|master\_itemid|ID|ID dell'item master.<br>È consentita la ricorsione fino a 3 item dipendenti e un numero massimo di item dipendenti pari a 999.<br>La regola di discovery non può essere l'item master di un'altra regola di discovery.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "Dependent item"<br>- *read-only* per gli oggetti ereditati|
|output\_format|integer|Indica se la risposta deve essere convertita in JSON.<br><br>Valori possibili:<br>0 - *(default)* Memorizza i dati grezzi;<br>1 - Converti in JSON.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|params|string|Parametri aggiuntivi a seconda del tipo di regola LLD:<br>- script eseguito per le regole LLD SSH e Telnet;<br>- query SQL per le regole LLD database monitor;<br>- formula per le regole LLD calcolate;<br>- script per le regole LLD script e browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "Database monitor", "SSH agent", "TELNET agent", "Script" o "Browser"<br>- *read-only* per gli oggetti ereditati (se `type` è impostato su "Script" o "Browser")|
|parameters|object/array|Parametri aggiuntivi se `type` è impostato su "Script" o "Browser".<br>Array di oggetti con proprietà `name` e `value`, dove `name` deve essere univoco.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "Script" o "Browser"<br>- *read-only* per gli oggetti ereditati|
|password|string|Password per l'autenticazione.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "JMX agent" e `username` è impostato<br>- *supported* se `type` è impostato su "Simple check", "Database monitor", "SSH agent", "TELNET agent" o "HTTP agent"<br>- *read-only* per gli oggetti ereditati (se `type` è impostato su "HTTP agent")|
|post\_type|integer|Tipo del corpo dei dati POST memorizzato nella proprietà `posts`.<br><br>Valori possibili:<br>0 - *(default)* Dati grezzi;<br>2 - Dati JSON;<br>3 - Dati XML.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|posts|string|Dati del corpo della richiesta HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "HTTP agent" e `post_type` è impostato su "JSON data" o "XML data"<br>- *supported* se `type` è impostato su "HTTP agent" e `post_type` è impostato su "Raw data"<br>- *read-only* per gli oggetti ereditati|
|privatekey|string|Nome del file della chiave privata.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "SSH agent" e `authtype` è impostato su "public key"|
|publickey|string|Nome del file della chiave pubblica.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "SSH agent" e `authtype` è impostato su "public key"|
|query\_fields|array|Array di [query fields](#http-query-field) che verranno inviati durante l'esecuzione di una richiesta HTTP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|request\_method|integer|Tipo di metodo della richiesta.<br><br>Valori possibili:<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* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|retrieve\_mode|integer|Parte della risposta che deve essere memorizzata.<br><br>Valori possibili se `request_method` è impostato su "GET", "POST" o "PUT":<br>0 - *(default)* Corpo;<br>1 - Headers;<br>2 - Verranno memorizzati sia il corpo sia gli headers.<br><br>Valori possibili se `request_method` è impostato su "HEAD":<br>1 - Headers.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|snmp\_oid|string|OID SNMP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "SNMP agent"<br>- *read-only* per gli oggetti ereditati|
|ssl\_cert\_file|string|Percorso del file della chiave SSL pubblica.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|ssl\_key\_file|string|Percorso del file della chiave SSL privata.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|ssl\_key\_password|string|Password per il file della chiave SSL.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|state|integer|Stato della regola LLD.<br><br>Valori possibili:<br>0 - *(default)* normale;<br>1 - non supportato.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|status|integer|Stato della regola LLD.<br><br>Valori possibili:<br>0 - *(default)* regola LLD abilitata;<br>1 - regola LLD disabilitata.|
|status\_codes|string|Intervalli dei codici di stato HTTP richiesti, separati da virgole. Supporta anche macro utente come parte di un elenco separato da virgole.<br><br>Esempio: 200,200-{$M},{$M},200-400<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|templateid|ID|ID della regola LLD del template padre.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|timeout|string|Timeout della richiesta di polling dei dati dell'item.<br>Accetta secondi o un'unità di tempo con suffisso (ad esempio, 30s, 1m). Accetta anche macro utente.<br><br>Intervallo di valori possibili: 1-600s.<br><br>Predefinito: "" - usa le impostazioni del proxy/globali.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "Zabbix agent" (0), "Simple check" (3) e `key_` non inizia con "`vmware.`" e "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) e `snmp_oid` inizia con "`walk[`" o "`get[`", "Script" (21), "Browser" (22)<br>- *read-only* per gli oggetti ereditati|
|trapper\_hosts|string|Host consentiti.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "Zabbix trapper", oppure se `type` è impostato su "HTTP agent" e `allow_traps` è impostato su "Allow to accept incoming data"|
|username|string|Nome utente per l'autenticazione.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "SSH agent", "TELNET agent", oppure se `type` è impostato su "JMX agent" e `password` è impostato<br>- *supported* se `type` è impostato su "Simple check", "Database monitor" o "HTTP agent"<br>- *read-only* per gli oggetti ereditati (se `type` è impostato su "HTTP agent")|
|uuid|string|Identificatore univoco universale, usato per collegare le regole LLD importate a quelle già esistenti. Generato automaticamente, se non specificato.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se la regola LLD appartiene a un template|
|verify\_host|integer|Indica se convalidare che il nome host della connessione corrisponda a quello nel certificato dell'host.<br><br>Valori possibili:<br>0 - *(default)* Non convalidare;<br>1 - Convalidare.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|
|verify\_peer|integer|Indica se convalidare che il certificato dell'host sia autentico.<br><br>Valori possibili:<br>0 - *(default)* Non convalidare;<br>1 - Convalidare.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* se `type` è impostato su "HTTP agent"<br>- *read-only* per gli oggetti ereditati|

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

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

L'oggetto header ha le seguenti proprietà:

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--------|---------------------------------------------------|-----------|
|name|string|Nome dell'intestazione HTTP.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|
|value|string|Valore dell'intestazione.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|

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

[comment]: # ({5b4177f3-ab8034d8})
#### Campo di query HTTP

L'oggetto campo di query definisce un nome e un valore utilizzati per specificare un parametro URL.
Ha le seguenti proprietà:

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--------|---------------------------------------------------|-----------|
|name|string|Nome del parametro.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|
|value|string|Valore del parametro.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|

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

[comment]: # ({7bfc5ecb-b0412737})
### Filtro della regola LLD

L'oggetto filtro della regola LLD definisce un insieme di condizioni che possono essere usate
per filtrare gli oggetti rilevati. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|conditions|object/array|Insieme di [condizioni di filtro](#lld-rule-filter-condition) da usare per filtrare i risultati. Le condizioni saranno ordinate nell'ordine della loro posizione nella formula.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|evaltype|integer|[Metodo di valutazione](/manual/discovery/low_level_discovery#filter) delle condizioni di filtro.<br><br>Valori possibili:<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Espressione personalizzata.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|eval\_formula|string|Espressione generata che verrà usata per valutare le condizioni di filtro. L'espressione contiene ID che fanno riferimento a specifiche condizioni di filtro tramite il loro `formulaid`. Il valore di `eval_formula` è uguale al valore di `formula` per i filtri con un'espressione personalizzata.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|formula|string|Espressione definita dall'utente da usare per valutare le condizioni dei filtri con un'espressione personalizzata. L'espressione deve contenere ID che fanno riferimento a specifiche condizioni di filtro tramite il loro `formulaid`. Gli ID usati nell'espressione devono corrispondere esattamente a quelli definiti nelle condizioni di filtro: nessuna condizione può rimanere inutilizzata o omessa.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *required* se `evaltype` è impostato su "custom expression"|

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

[comment]: # ({d0e9011a-be83ef5c})
#### Condizione del filtro della regola LLD

L'oggetto condizione del filtro della regola LLD definisce un controllo separato da eseguire sul valore di una macro LLD. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|macro|string|Macro LLD su cui eseguire il controllo.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Valore con cui confrontare.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `operator` è impostato su "matches regular expression" o "does not match regular expression"|
|formulaid|string|ID univoco arbitrario utilizzato per fare riferimento alla condizione da un'espressione personalizzata. Può contenere solo lettere maiuscole. L'ID deve essere definito dall'utente quando si modificano le condizioni del filtro, ma verrà generato nuovamente nelle richieste successive.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `evaltype` dell'[oggetto filtro della regola LLD](#lld-rule-filter) è impostato su "custom expression"|
|operator|integer|Operatore della condizione.<br><br>Valori possibili:<br>8 - *(default)* corrisponde all'espressione regolare;<br>9 - non corrisponde all'espressione regolare;<br>12 - esiste;<br>13 - non esiste.|

::: notetip
Per comprendere meglio come usare i filtri con vari
tipi di espressioni, vedere gli esempi nelle pagine dei metodi
[discoveryrule.get](get#retrieving-filter-conditions) e
[discoveryrule.create](create#using-a-custom-expression-filter).
:::

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

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

Il percorso della macro LLD ha le seguenti proprietà:

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|lld\_macro|string|Macro LLD.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|
|path|string|Selettore per il valore che verrà assegnato alla macro corrispondente.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|

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

[comment]: # ({0769e0f5-14dc55c1})
### Preprocessing della regola LLD

L'oggetto di preprocessing della regola LLD ha le seguenti proprietà.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|Il tipo di opzione di preprocessing.<br><br>Valori possibili:<br>5 - Espressione regolare;<br>11 - XML XPath;<br>12 - JSONPath;<br>14 - Corrisponde all'espressione regolare;<br>15 - Non corrisponde all'espressione regolare;<br>16 - Controlla la presenza di errori in JSON;<br>17 - Controlla la presenza di errori in XML;<br>20 - Scarta i valori invariati con heartbeat;<br>21 - JavaScript;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Sostituisci;<br>27 - XML to JSON;<br>28 - Valore SNMP walk;<br>29 - SNMP walk to JSON;<br>30 - Valore SNMP get.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|params|string|Parametri aggiuntivi usati dall'opzione di preprocessing. Più parametri sono separati dal carattere di nuova riga (\\n).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "Espressione regolare" (5), "XML XPath" (11), "JSONPath" (12), "Corrisponde all'espressione regolare" (14), "Non corrisponde all'espressione regolare" (15), "Controlla la presenza di errori in JSON" (16), "Controlla la presenza di errori in XML" (17), "Scarta i valori invariati con heartbeat" (20), "JavaScript" (21), "Prometheus to JSON" (23), "CSV to JSON" (24), "Sostituisci" (25), "Valore SNMP walk" (28), "SNMP walk to JSON" (29) o "Valore SNMP get" (30)|
|error\_handler|integer|Tipo di azione usata in caso di errore del passaggio di preprocessing.<br><br>Valori possibili:<br>0 - Il messaggio di errore viene impostato da Zabbix server;<br>1 - Scarta il valore;<br>2 - Imposta un valore personalizzato;<br>3 - Imposta un messaggio di errore personalizzato.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `type` è impostato su "Espressione regolare" (5), "XML XPath" (11), "JSONPath" (12), "Corrisponde all'espressione regolare" (14), "Non corrisponde all'espressione regolare" (15), "Controlla la presenza di errori in JSON" (16), "Controlla la presenza di errori in XML" (17), "Prometheus to JSON" (23), "CSV to JSON" (24), "XML to JSON" (27), "Valore SNMP walk" (28), "SNMP walk to JSON" (29) o "Valore SNMP get" (30)|
|error\_handler\_params|string|Parametri del gestore degli errori.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `error_handler` è impostato su "Imposta un valore personalizzato" o "Imposta un messaggio di errore personalizzato"|

I seguenti parametri e gestori degli errori sono supportati per ciascun tipo di preprocessing.

|Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers|
|------------------|----|-----------|-----------|-----------|------------------------|
|5|Espressione regolare|pattern^1^|output^2^|<|0, 1, 2, 3|
|11|XML XPath|path^3^|<|<|0, 1, 2, 3|
|12|JSONPath|path^3^|<|<|0, 1, 2, 3|
|14|Corrisponde all'espressione regolare|pattern^1^|<|<|0, 1, 2, 3|
|15|Non corrisponde all'espressione regolare|pattern^1^|<|<|0, 1, 2, 3|
|16|Controlla la presenza di errori in JSON|path^3^|<|<|0, 1, 2, 3|
|17|Controlla la presenza di errori in XML|path^3^|<|<|0, 1, 2, 3|
|20|Scarta i valori invariati con heartbeat|seconds^4, 5^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|23|Prometheus to JSON|pattern^5, 6^|<|<|0, 1, 2, 3|
|24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3|
|25|Sostituisci|search string^2^|replacement^2^|<|<|
|27|XML to JSON|<|<|<|0, 1, 2, 3|
|28|SNMP walk value|OID^2^|Format:<br>0 - Invariato<br>1 - UTF-8 da Hex-STRING<br>2 - MAC da Hex-STRING<br>3 - Integer da BITS|<|0, 1, 2, 3|
|29|SNMP walk to JSON^7^|Field name^2^|OID prefix^2^|Format:<br>0 - Invariato<br>1 - UTF-8 da Hex-STRING<br>2 - MAC da Hex-STRING<br>3 - Integer da BITS|0, 1, 2, 3|
|30|SNMP get value|Format:<br>1 - UTF-8 da Hex-STRING<br>2 - MAC da Hex-STRING<br>3 - Integer da BITS|<|<|0, 1, 2, 3|

^1^ espressione regolare<br>
^2^ stringa<br>
^3^ JSONPath o XML XPath<br>
^4^ intero positivo (con supporto dei suffissi temporali, ad esempio 30s, 1m, 2h,
1d)<br>
^5^ macro utente<br>
^6^ pattern Prometheus seguendo la sintassi:
`<metric name>{<label name>="<label value>", ...} == <value>`. Ogni
componente del pattern Prometheus (metric, label name, label value e metric
value) può essere una macro utente.<br>
^7^ Supporta più record "Field name,OID prefix,Format" delimitati da un carattere di nuova riga.

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

[comment]: # ({f2f34ac6-2f32e5f0})
### Override delle regole LLD

L'oggetto override delle regole LLD definisce un insieme di regole (filtri,
condizioni e operazioni) utilizzate per sovrascrivere le proprietà di
diversi oggetti prototype. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|name|string|Nome univoco dell'override.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|step|integer|Numero d'ordine univoco dell'override.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|stop|integer|Interrompe l'elaborazione degli override successivi se corrisponde.<br><br>Valori possibili:<br>0 - *(default)* non interrompere l'elaborazione degli override;<br>1 - interrompere l'elaborazione degli override se il filtro corrisponde.|
|filter|object|Filtro dell'override.|
|operations|object/array|Operazioni dell'override.|

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

[comment]: # ({67737988-573b52c4})
#### Filtro di override della regola LLD

L'oggetto filtro di override della regola LLD definisce un insieme di condizioni che, se corrispondono all'oggetto rilevato, applicano l'override. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|conditions|object/array|Insieme di [condizioni del filtro di override](#lld-rule-override-filter-condition) da usare per la corrispondenza con gli oggetti rilevati. Le condizioni verranno ordinate nell'ordine in cui compaiono nella formula.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|evaltype|integer|[Metodo di valutazione](/manual/discovery/low_level_discovery#override) delle condizioni del filtro di override.<br><br>Valori possibili:<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Espressione personalizzata.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|eval\_formula|string|Espressione generata che verrà usata per valutare le condizioni del filtro di override. L'espressione contiene ID che fanno riferimento a specifiche condizioni del filtro di override tramite il loro `formulaid`. Il valore di `eval_formula` è uguale al valore di `formula` per i filtri con un'espressione personalizzata.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|formula|string|Espressione definita dall'utente da usare per valutare le condizioni dei filtri di override con un'espressione personalizzata. L'espressione deve contenere ID che fanno riferimento a specifiche condizioni del filtro di override tramite il loro `formulaid`. Gli ID usati nell'espressione devono corrispondere esattamente a quelli definiti nelle condizioni del filtro di override: nessuna condizione può rimanere inutilizzata o omessa.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` is set to "custom expression"|

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

[comment]: # ({a2dc636e-e47f6c6a})
##### Condizione del filtro di override della regola LLD

L'oggetto condizione del filtro di override della regola LLD definisce un controllo separato
da eseguire sul valore di una macro LLD. Ha le seguenti
proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|macro|string|Macro LLD su cui eseguire il controllo.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Valore con cui confrontare.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `operator` è impostato su "matches regular expression" o "does not match regular expression"|
|formulaid|string|ID univoco arbitrario utilizzato per fare riferimento alla condizione da un'espressione personalizzata. Può contenere solo lettere maiuscole. L'ID deve essere definito dall'utente quando modifica le condizioni del filtro, ma verrà generato nuovamente nelle richieste successive.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `evaltype` dell'[oggetto filtro di override della regola LLD](#lld-rule-override-filter) è impostato su "custom expression"|
|operator|integer|Operatore della condizione.<br><br>Valori possibili:<br>8 - *(default)* corrisponde all'espressione regolare;<br>9 - non corrisponde all'espressione regolare;<br>12 - esiste;<br>13 - non esiste.|

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

[comment]: # ({334e5e5e-e7b08f3c})
#### Operazione di override della regola LLD

L'operazione di override della regola LLD è una combinazione di condizioni e azioni da eseguire sull'oggetto prototipo. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|operationobject|integer|Tipo di oggetto scoperto su cui eseguire l'azione.<br><br>Valori possibili:<br>0 - Item prototype;<br>1 - Trigger prototype;<br>2 - Graph prototype;<br>3 - Host prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|operator|integer|Operatore della condizione di override [operator](/manual/discovery/low_level_discovery#override).<br><br>Valori possibili:<br>0 - *(default)* uguale a;<br>1 - diverso da;<br>2 - contiene;<br>3 - non contiene;<br>8 - corrisponde a;<br>9 - non corrisponde a.|
|value|string|Pattern da confrontare con il nome del prototipo di item, trigger, graph o host in base all'oggetto selezionato.|
|opstatus|object|Oggetto di stato dell'operazione di override per gli oggetti item, trigger e host prototype.|
|opdiscover|object|Oggetto di stato discover dell'operazione di override (tutti i tipi di oggetto).|
|opperiod|object|Oggetto del periodo dell'operazione di override (intervallo di aggiornamento) per l'oggetto item prototype.|
|ophistory|object|Oggetto della cronologia dell'operazione di override per l'oggetto item prototype.|
|optrends|object|Oggetto delle tendenze dell'operazione di override per l'oggetto item prototype.|
|opseverity|object|Oggetto della severità dell'operazione di override per l'oggetto trigger prototype.|
|optag|object/array|Oggetto tag dell'operazione di override per gli oggetti trigger e host prototype.|
|optemplate|object/array|Oggetto template dell'operazione di override per l'oggetto host prototype.|
|opinventory|object|Oggetto inventario dell'operazione di override per l'oggetto host prototype.|

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

[comment]: # ({3d3c516a-52d3b579})
##### Stato dell'operazione di override della regola LLD

Stato dell'operazione di override della regola LLD impostato sull'oggetto rilevato. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|status|integer|Sovrascrive lo stato per l'oggetto selezionato.<br><br>Valori possibili:<br>0 - Creazione abilitata;<br>1 - Creazione disabilitata.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({9cdd5143-ff620350})
##### Operazione di override della regola LLD discover

Stato dell'operazione di override della regola LLD discover impostato sull'oggetto discovered. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|discover|integer|Sovrascrive lo stato discover per l'oggetto selezionato.<br><br>Valori possibili:<br>0 - Sì, continua a scoprire gli oggetti;<br>1 - No, i nuovi oggetti non verranno scoperti e quelli esistenti saranno contrassegnati come persi.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({94ba958f-6e469c1b})
##### Periodo dell'operazione di override della regola LLD

Il periodo dell'operazione di override della regola LLD è un valore dell'intervallo di aggiornamento impostato per l'item scoperto.
Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|delay|string|Sovrascrive l'intervallo di aggiornamento dell'item prototype.<br><br>Accetta secondi oppure un'unità di tempo con suffisso (ad esempio, 30s, 1m, 2h, 1d) e, facoltativamente, uno o più [intervalli personalizzati](/manual/config/items/item/custom_intervals), tutti separati da punti e virgola. Gli intervalli personalizzati possono essere una combinazione di intervalli flessibili e di pianificazione.<br><br>Accetta macro utente o macro LLD (il supporto delle macro LLD è stato ripristinato in Zabbix 7.0.27). Se utilizzato, il valore deve essere una singola macro. Non sono supportate più macro o macro mescolate con testo. Gli intervalli flessibili possono essere scritti come due macro separate da una barra obliqua (ad esempio, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Esempio:<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({a8b2ff35-ff97489f})
##### Cronologia dell'operazione di override della regola LLD

Valore della cronologia dell'operazione di override della regola LLD impostato sull'item scoperto.
Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|history|string|Sovrascrive la cronologia del prototipo di item, che è un'unità di tempo che indica per quanto tempo i dati di cronologia devono essere conservati. Accetta anche macro utente e macro LLD (il supporto delle macro LLD è stato ripristinato in Zabbix 7.0.27).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({414499ea-10b52601})
##### Andamento dell'operazione di override della regola LLD per trends

Valore dell'operazione di override della regola LLD per trends impostato sull'item scoperto.
Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|trends|string|Sovrascrive i trends del prototipo di item, che è un'unità di tempo che definisce per quanto tempo i dati dei trends devono essere conservati. Accetta anche macro utente e macro LLD (il supporto delle macro LLD è stato ripristinato in Zabbix 7.0.27).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({e551a258-991f3bdc})
##### Severità dell'operazione di override della regola LLD

Valore di severità dell'operazione di override della regola LLD impostato sul trigger scoperto. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|severity|integer|Sovrascrive la severità del trigger prototype.<br><br>Valori possibili:<br>0 - *(default)* non classificato;<br>1 - informativo;<br>2 - warning;<br>3 - medio;<br>4 - alto;<br>5 - disastro.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({427bdb05-0693b8f3})
##### Tag dell'operazione di override della regola LLD

L'oggetto tag dell'operazione di override della regola LLD contiene il nome del tag e il valore che vengono impostati sull'oggetto rilevato. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nuovo nome del tag. Accetta anche macro utente e macro LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Nuovo valore del tag. Accetta anche macro utente e macro LLD.|

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

[comment]: # ({0e075e84-5eebc05a})
##### Template operazione di override della regola LLD

Oggetto template dell'operazione di override della regola LLD che è collegato all'host scoperto. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|templateid|ID|Sovrascrive il template dei template collegati del prototipo di host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({e26c68ed-9c5cc3d1})
##### Inventario dell'operazione di override della regola LLD

Valore della modalità di inventario dell'operazione di override della regola LLD impostato sull'host scoperto. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|inventory\_mode|integer|Sovrascrive la modalità di inventario del prototipo di host.<br><br>Valori possibili:<br>-1 - disabilitato;<br>0 - *(predefinito)* manuale;<br>1 - automatico.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|

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