[comment]: # aside: 1

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

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

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

[comment]: # ({33580c07-c17fa830})
### Regola LLD

L'oggetto regola di low-level discovery ha le seguenti proprietà.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID della regola LLD.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *obbligatoria* 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 pianificati.<br><br>Accetta macro utente. Se utilizzato, il valore deve essere una singola macro. Macro multiple o macro combinate con testo non sono supportate. Gli intervalli flessibili possono essere scritti come due macro separate da una barra (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>- *obbligatoria* 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 del host a cui appartiene la regola LLD.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *costante*<br>- *obbligatoria* per le operazioni di creazione|
|flags|integer|[Origine](/manual/api/reference_commentary#entity-origin-flags) della regola di discovery.<br><br>Valori possibili:<br>1 - una regola di low-level discovery;<br>5 - una regola di low-level discovery convertita da prototipo.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|interfaceid|ID|ID dell'interfaccia host della regola LLD.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se la regola LLD appartiene a un host e `type` è impostato su "Zabbix agent", "IPMI agent", "JMX agent" o "SNMP agent"<br>- *supportata* 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>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione<br>- *sola lettura* per gli oggetti ereditati|
|name|string|Nome della regola LLD.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione<br>- *sola lettura* 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 - item dipendente;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script;<br>22 - Browser;<br>23 - Nidificato. Questo tipo è consentito solo se il genitore della regola è un template (che si presume sia collegato a un prototipo host durante la discovery) o un host rilevato (che ha una regola LLD alla sua radice).<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione<br>- *sola lettura* per gli oggetti ereditati|
|url|string|Stringa URL.<br>Supporta macro utente, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|allow\_traps|integer|Consente di popolare il valore in modo simile al trapper item.<br><br>Valori possibili:<br>0 - *(predefinito)* Non consentire l'accettazione di dati in ingresso;<br>1 - Consentire l'accettazione di dati in ingresso.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"|
|authtype|integer|Metodo di autenticazione.<br><br>Valori possibili se `type` è impostato su "SSH agent":<br>0 - *(predefinito)* password;<br>1 - chiave pubblica.<br><br>Valori possibili se `type` è impostato su "HTTP agent":<br>0 - *(predefinito)* nessuno;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "SSH agent" o "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati (se `type` è impostato su "HTTP agent")|
|description|string|Descrizione della regola LLD.|
|error|string|Testo dell'errore se si verificano problemi durante l'aggiornamento del valore della regola LLD.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|follow\_redirects|integer|Segui i reindirizzamenti della risposta durante il polling dei dati.<br><br>Valori possibili:<br>0 - Non seguire i reindirizzamenti;<br>1 - *(predefinito)* Seguire i reindirizzamenti.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|headers|array|Array di [header](#http-header) che verranno inviati durante l'esecuzione di una richiesta HTTP.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|http\_proxy|string|Stringa di connessione del proxy HTTP(S).<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|ipmi\_sensor|string|Sensore IPMI.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "IPMI agent" e `key_` non è impostato su "ipmi.get"<br>- *supportata* se `type` è impostato su "IPMI agent"<br>- *sola lettura* per gli oggetti ereditati|
|jmx\_endpoint|string|Stringa di connessione personalizzata di JMX agent.<br><br>Predefinito: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "JMX agent"|
|lifetime|string|Periodo di tempo dopo il quale gli item non più rilevati 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 - *(predefinito)* 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ù rilevati 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 - *(predefinito)* Disabilita immediatamente.|
|master\_itemid|ID|ID del master item.<br>La regola di discovery non può essere un master item per un'altra regola di discovery.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "Dependent item"<br>- *sola lettura* per gli oggetti ereditati|
|output\_format|integer|Indica se la risposta deve essere convertita in JSON.<br><br>Valori possibili:<br>0 - *(predefinito)* Memorizza grezzo;<br>1 - Converti in JSON.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* 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>- lo script per le regole LLD script e browser.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "Database monitor", "SSH agent", "TELNET agent", "Script" o "Browser"<br>- *sola lettura* 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>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "Script" o "Browser"<br>- *sola lettura* per gli oggetti ereditati|
|password|string|Password per l'autenticazione.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "JMX agent" e `username` è impostato<br>- *supportata* se `type` è impostato su "Simple check", "Database monitor", "SSH agent", "TELNET agent" o "HTTP agent"<br>- *sola lettura* 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 - *(predefinito)* Dati grezzi;<br>2 - Dati JSON;<br>3 - Dati XML.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|posts|string|Dati del corpo della richiesta HTTP(S).<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "HTTP agent" e `post_type` è impostato su "JSON data" o "XML data"<br>- *supportata* se `type` è impostato su "HTTP agent" e `post_type` è impostato su "Raw data"<br>- *sola lettura* per gli oggetti ereditati|
|privatekey|string|Nome del file della chiave privata.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "SSH agent" e `authtype` è impostato su "public key"|
|publickey|string|Nome del file della chiave pubblica.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "SSH agent" e `authtype` è impostato su "public key"|
|query\_fields|array|Array di [campi query](#http-query-field) che verranno inviati durante l'esecuzione di una richiesta HTTP.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|request\_method|integer|Tipo di metodo della richiesta.<br><br>Valori possibili:<br>0 - *(predefinito)* GET;<br>1 - POST;<br>2 - PUT;<br>3 - HEAD.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|retrieve\_mode|integer|Quale parte della risposta deve essere memorizzata.<br><br>Valori possibili se `request_method` è impostato su "GET", "POST" o "PUT":<br>0 - *(predefinito)* Corpo;<br>1 - Header;<br>2 - Verranno memorizzati sia il corpo che gli header.<br><br>Valori possibili se `request_method` è impostato su "HEAD":<br>1 - Header.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|snmp\_oid|string|OID SNMP.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "SNMP agent"<br>- *sola lettura* per gli oggetti ereditati|
|ssl\_cert\_file|string|Percorso del file della chiave SSL pubblica.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|ssl\_key\_file|string|Percorso del file della chiave SSL privata.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|ssl\_key\_password|string|Password per il file della chiave SSL.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|state|integer|Stato della regola LLD.<br><br>Valori possibili:<br>0 - *(predefinito)* normale;<br>1 - non supportato.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|status|integer|Stato della regola LLD.<br><br>Valori possibili:<br>0 - *(predefinito)* 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>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|templateid|ID|ID della regola LLD del template padre.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|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 globali/del proxy.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* 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>- *sola lettura* per gli oggetti ereditati|
|trapper\_hosts|string|Host consentiti.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* 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>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `type` è impostato su "SSH agent", "TELNET agent", oppure se `type` è impostato su "JMX agent" e `password` è impostato<br>- *supportata* se `type` è impostato su "Simple check", "Database monitor" o "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati (se `type` è impostato su "HTTP agent")|
|uuid|string|Identificatore univoco universale, utilizzato per collegare le regole LLD importate a quelle già esistenti. Generato automaticamente, se non fornito.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se la regola LLD appartiene a un template|
|verify\_host|integer|Indica se verificare che il nome host per la connessione corrisponda a quello nel certificato dell'host.<br><br>Valori possibili:<br>0 - *(predefinito)* Non verificare;<br>1 - Verificare.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|
|verify\_peer|integer|Indica se verificare che il certificato dell'host sia autentico.<br><br>Valori possibili:<br>0 - *(predefinito)* Non verificare;<br>1 - Verificare.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* se `type` è impostato su "HTTP agent"<br>- *sola lettura* per gli oggetti ereditati|

[comment]: # ({/33580c07-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 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#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>[Property behavior](/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 relativo `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 con un'espressione personalizzata. L'espressione deve contenere ID che fanno riferimento a specifiche condizioni di filtro tramite il relativo `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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* se `evaltype` è impostato su "custom expression"|

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

[comment]: # ({92f63faf-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'[LLD rule filter object](#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, consulta gli esempi nelle pagine dei metodi [discoveryrule.get](get#retrieving-filter-conditions) e [discoveryrule.create](create#using-a-custom-expression-filter).
:::

[comment]: # ({/92f63faf-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 dal server Zabbix;<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|Valore SNMP walk|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|Valore SNMP get|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 es. 30s, 1m, 2h,
1d)<br>
^5^ macro utente<br>
^6^ pattern Prometheus secondo la sintassi:
`<metric name>{<label name>="<label value>", ...} == <value>`. Ogni
componente del pattern Prometheus (metrica, nome etichetta, valore etichetta e valore della metrica)
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 saranno 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 relativo `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 relativo `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]: # ({02af08bb-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>4 - Discovery 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 di 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 gravità 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]: # ({/02af08bb-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 scoperto. Ha le seguenti proprietà:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|discover|integer|Sovrascrive lo stato di 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 verranno contrassegnati come persi.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({b3bef187-6e469c1b})
##### Periodo operativo di override della regola LLD

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|delay|string|Esegue l'override dell'intervallo di aggiornamento del prototipo di item.<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 punto e virgola. Gli intervalli personalizzati possono essere una combinazione di intervalli flessibili e pianificati.<br><br>Accetta macro utente o macro LLD. Se utilizzato, il valore deve essere una singola macro. Macro multiple o macro combinate con testo non sono supportate. Gli intervalli flessibili possono essere scritti come due macro separate da una barra (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]: # ({/b3bef187-6e469c1b})

[comment]: # ({28d8eca2-ff97489f})
##### Cronologia delle operazioni di override della regola LLD

Valore della cronologia delle operazioni 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 della cronologia devono essere conservati. Accetta anche macro utente e macro LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({a1ea1935-10b52601})
##### Tendenze delle operazioni di override della regola LLD

Valore delle tendenze delle operazioni di override della regola LLD impostato sull'item individuato.
Ha le seguenti proprietà:

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|trends|string|Esegue l'override delle tendenze del prototipo di item, che rappresentano un'unità di tempo per quanto a lungo i dati di tendenza devono essere conservati. Accetta anche macro utente e macro LLD.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|

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

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

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|severity|integer|Sovrascrive la gravità del trigger prototype.<br><br>Valori possibili:<br>0 - *(default)* non classificato;<br>1 - informazione;<br>2 - avviso;<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]: # ({71613716-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 individuato. Ha le seguenti proprietà:

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

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

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

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|templateid|ID|Sostituisce 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})
