[comment]: # aside:1

[comment]: # ({3bf923db-c5a9e121})
# Obiekt reguły LLD (Low Level Discovery)

Następujące obiekty są bezpośrednio powiązane z API `discoveryrule`.

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

[comment]: # ({33580c07-c17fa830})
### Reguła LLD

Obiekt reguły wykrywania niskiego poziomu ma następujące właściwości.

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|itemid|ID|ID reguły LLD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*<br>- *wymagane* dla operacji aktualizacji|
|delay|string|Interwał aktualizacji reguły LLD.<br><br>Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m, 2h, 1d) oraz opcjonalnie jeden lub więcej [niestandardowych interwałów](/manual/config/items/item/custom_intervals), wszystkie oddzielone średnikami. Niestandardowe interwały mogą być kombinacją interwałów elastycznych i harmonogramowanych.<br><br>Akceptuje makra użytkownika. Jeśli są używane, wartość musi być pojedynczym makrem. Wiele makr lub makra zmieszane z tekstem nie są obsługiwane. Interwały elastyczne mogą być zapisane jako dwa makra oddzielone ukośnikiem (np. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Przykład:<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "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), lub jeśli `type` jest ustawione na "Zabbix agent (active)" (7) i `key_` nie zawiera "mqtt.get"|
|hostid|ID|ID hosta, do którego należy reguła LLD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *stałe*<br>- *wymagane* dla operacji tworzenia|
|flags|integer|[Pochodzenie](/manual/api/reference_commentary#entity-origin-flags) reguły wykrywania.<br><br>Możliwe wartości:<br>1 - reguła wykrywania niskiego poziomu;<br>5 - reguła wykrywania niskiego poziomu przekonwertowana z prototypu.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|interfaceid|ID|ID interfejsu hosta reguły LLD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli reguła LLD należy do hosta i `type` jest ustawione na "Zabbix agent", "IPMI agent", "JMX agent" lub "SNMP agent"<br>- *obsługiwane*, jeśli reguła LLD należy do hosta i `type` jest ustawione na "Simple check", "External check", "SSH agent", "TELNET agent" lub "HTTP agent"|
|key\_|string|Klucz reguły LLD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|name|string|Nazwa reguły LLD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|type|integer|Typ reguły LLD.<br><br>Możliwe wartości:<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 - pozycja zależna;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script;<br>22 - Browser;<br>23 - Zagnieżdżony. Ten typ jest dozwolony tylko wtedy, gdy nadrzędna reguła jest szablonem (zakłada się, że jest podłączony do prototypu hosta podczas wykrywania) lub wykrytym hostem (który ma regułę LLD w swoim korzeniu).<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|url|string|Ciąg URL.<br>Obsługuje makra użytkownika, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|allow\_traps|integer|Pozwala wypełniać wartość podobnie jak w pozycji trapper.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Nie zezwalaj na przyjmowanie danych przychodzących;<br>1 - Zezwalaj na przyjmowanie danych przychodzących.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"|
|authtype|integer|Metoda uwierzytelniania.<br><br>Możliwe wartości, jeśli `type` jest ustawione na "SSH agent":<br>0 - *(domyślnie)* hasło;<br>1 - klucz publiczny.<br><br>Możliwe wartości, jeśli `type` jest ustawione na "HTTP agent":<br>0 - *(domyślnie)* brak;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "SSH agent" lub "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` jest ustawione na "HTTP agent")|
|description|string|Opis reguły LLD.|
|error|string|Tekst błędu, jeśli występują problemy z aktualizacją wartości reguły LLD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|follow\_redirects|integer|Podążanie za przekierowaniami odpowiedzi podczas odpytywania danych.<br><br>Możliwe wartości:<br>0 - Nie podążaj za przekierowaniami;<br>1 - *(domyślnie)* Podążaj za przekierowaniami.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|headers|array|Tablica [nagłówków](#http-header), które zostaną wysłane podczas wykonywania żądania HTTP.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|http\_proxy|string|Ciąg połączenia proxy HTTP(S).<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|ipmi\_sensor|string|Czujnik IPMI.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "IPMI agent" i `key_` nie jest ustawione na "ipmi.get"<br>- *obsługiwane*, jeśli `type` jest ustawione na "IPMI agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|jmx\_endpoint|string|Niestandardowy ciąg połączenia JMX agent.<br><br>Domyślnie: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "JMX agent"|
|lifetime|string|Okres czasu, po którym pozycje, które nie są już wykrywane, zostaną usunięte. Akceptuje sekundy, jednostkę czasu z sufiksem lub makro użytkownika.<br><br>Domyślnie: `7d`.|
|lifetime\_type|integer|Scenariusz usuwania utraconych zasobów LLD.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Usuń po osiągnięciu progu lifetime;<br>1 - Nie usuwaj;<br>2 - Usuń natychmiast.|
|enabled\_lifetime|string|Okres czasu, po którym pozycje, które nie są już wykrywane, zostaną wyłączone. Akceptuje sekundy, jednostkę czasu z sufiksem lub makro użytkownika.<br><br>Domyślnie: `0`.|
|enabled\_lifetime\_type|integer|Scenariusz wyłączania utraconych zasobów LLD.<br><br>Możliwe wartości:<br>0 - Wyłącz po osiągnięciu progu lifetime;<br>1 - Nie wyłączaj;<br>2 - *(domyślnie)* Wyłącz natychmiast.|
|master\_itemid|ID|ID pozycji nadrzędnej.<br>Reguła wykrywania nie może być pozycją nadrzędną dla innej reguły wykrywania.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "Dependent item"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|output\_format|integer|Czy odpowiedź powinna zostać przekonwertowana do JSON.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Przechowuj surowe dane;<br>1 - Konwertuj do JSON.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|params|string|Dodatkowe parametry zależne od typu reguły LLD:<br>- wykonywany skrypt dla reguł LLD SSH i Telnet;<br>- zapytanie SQL dla reguł LLD monitora bazy danych;<br>- formuła dla obliczanych reguł LLD;<br>- skrypt dla reguł LLD typu script i browser.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "Database monitor", "SSH agent", "TELNET agent", "Script" lub "Browser"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` jest ustawione na "Script" lub "Browser")|
|parameters|object/array|Dodatkowe parametry, jeśli `type` jest ustawione na "Script" lub "Browser".<br>Tablica obiektów z właściwościami `name` i `value`, gdzie `name` musi być unikalne.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "Script" lub "Browser"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|password|string|Hasło do uwierzytelniania.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "JMX agent" i `username` jest ustawione<br>- *obsługiwane*, jeśli `type` jest ustawione na "Simple check", "Database monitor", "SSH agent", "TELNET agent" lub "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` jest ustawione na "HTTP agent")|
|post\_type|integer|Typ treści danych POST przechowywanych we właściwości `posts`.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Surowe dane;<br>2 - Dane JSON;<br>3 - Dane XML.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|posts|string|Dane treści żądania HTTP(S).<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "HTTP agent" i `post_type` jest ustawione na "JSON data" lub "XML data"<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent" i `post_type` jest ustawione na "Raw data"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|privatekey|string|Nazwa pliku klucza prywatnego.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "SSH agent" i `authtype` jest ustawione na "public key"|
|publickey|string|Nazwa pliku klucza publicznego.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "SSH agent" i `authtype` jest ustawione na "public key"|
|query\_fields|array|Tablica [pól zapytania](#http-query-field), które zostaną wysłane podczas wykonywania żądania HTTP.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|request\_method|integer|Typ metody żądania.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* GET;<br>1 - POST;<br>2 - PUT;<br>3 - HEAD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|retrieve\_mode|integer|Która część odpowiedzi powinna zostać zapisana.<br><br>Możliwe wartości, jeśli `request_method` jest ustawione na "GET", "POST" lub "PUT":<br>0 - *(domyślnie)* Treść;<br>1 - Nagłówki;<br>2 - Zostaną zapisane zarówno treść, jak i nagłówki.<br><br>Możliwe wartości, jeśli `request_method` jest ustawione na "HEAD":<br>1 - Nagłówki.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|snmp\_oid|string|OID SNMP.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "SNMP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|ssl\_cert\_file|string|Ścieżka do pliku publicznego klucza SSL.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|ssl\_key\_file|string|Ścieżka do pliku prywatnego klucza SSL.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|ssl\_key\_password|string|Hasło do pliku klucza SSL.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|state|integer|Stan reguły LLD.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* normalny;<br>1 - nieobsługiwane.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|status|integer|Status reguły LLD.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* włączona reguła LLD;<br>1 - wyłączona reguła LLD.|
|status\_codes|string|Zakresy wymaganych kodów statusu HTTP, oddzielone przecinkami. Obsługuje również makra użytkownika jako część listy rozdzielanej przecinkami.<br><br>Przykład: 200,200-{$M},{$M},200-400<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|templateid|ID|ID nadrzędnej reguły LLD szablonu.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|timeout|string|Limit czasu żądania odpytywania danych pozycji.<br>Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m). Akceptuje również makra użytkownika.<br><br>Zakres możliwych wartości: 1-600s.<br><br>Domyślnie: "" - użyj ustawień proxy/globalnych.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "Zabbix agent" (0), "Simple check" (3) i `key_` nie zaczyna się od "`vmware.`" ani "`icmpping`", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) i `snmp_oid` zaczyna się od "`walk[`" lub "`get[`", "Script" (21), "Browser" (22)<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|trapper\_hosts|string|Dozwolone hosty.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "Zabbix trapper", lub jeśli `type` jest ustawione na "HTTP agent" i `allow_traps` jest ustawione na "Allow to accept incoming data"|
|username|string|Nazwa użytkownika do uwierzytelniania.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "SSH agent", "TELNET agent", lub jeśli `type` jest ustawione na "JMX agent" i `password` jest ustawione<br>- *obsługiwane*, jeśli `type` jest ustawione na "Simple check", "Database monitor" lub "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` jest ustawione na "HTTP agent")|
|uuid|string|Uniwersalny unikalny identyfikator, używany do łączenia importowanych reguł LLD z już istniejącymi. Generowany automatycznie, jeśli nie został podany.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli reguła LLD należy do szablonu|
|verify\_host|integer|Czy weryfikować, że nazwa hosta dla połączenia odpowiada nazwie w certyfikacie hosta.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Nie weryfikuj;<br>1 - Weryfikuj.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|verify\_peer|integer|Czy weryfikować, że certyfikat hosta jest autentyczny.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Nie weryfikuj;<br>1 - Weryfikuj.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane*, jeśli `type` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|

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

[comment]: # ({ab5307fa-b531b70b})
#### Nagłówek HTTP

Obiekt nagłówka ma następujące właściwości:

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--------|---------------------------------------------------|-----------|
|name|string|Nazwa nagłówka HTTP.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|value|string|Wartość nagłówka.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|

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

[comment]: # ({5b4177f3-ab8034d8})
#### Pole zapytania HTTP

Obiekt pola zapytania definiuje nazwę i wartość używane do określenia parametru URL.
Ma następujące właściwości:

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--------|---------------------------------------------------|-----------|
|name|string|Nazwa parametru.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|value|string|Wartość parametru.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|

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

[comment]: # ({7bfc5ecb-b0412737})
### Filtr reguły LLD

Obiekt filtra reguły LLD definiuje zestaw warunków, które można wykorzystać
do filtrowania wykrytych obiektów. Ma on następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|conditions|object/array|Zestaw [warunków filtra](#lld-rule-filter-condition) używanych do filtrowania wyników. Warunki zostaną posortowane zgodnie z kolejnością ich umieszczenia we wzorze.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|evaltype|integer|[Metoda oceny](/manual/discovery/low_level_discovery#filter) warunków filtra.<br><br>Możliwe wartości:<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Wyrażenie niestandardowe.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|eval\_formula|string|Wygenerowane wyrażenie, które będzie używane do oceny warunków filtra. Wyrażenie zawiera identyfikatory odwołujące się do konkretnych warunków filtra za pomocą ich `formulaid`. Wartość `eval_formula` jest równa wartości `formula` dla filtrów z wyrażeniem niestandardowym.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|formula|string|Zdefiniowane przez użytkownika wyrażenie używane do oceny warunków filtrów z wyrażeniem niestandardowym. Wyrażenie musi zawierać identyfikatory odwołujące się do konkretnych warunków filtra za pomocą ich `formulaid`. Identyfikatory użyte w wyrażeniu muszą dokładnie odpowiadać tym zdefiniowanym w warunkach filtra: żaden warunek nie może pozostać nieużyty ani pominięty.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required* jeśli `evaltype` jest ustawione na "custom expression"|

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

[comment]: # ({92f63faf-be83ef5c})
#### Warunek filtra reguły LLD

Obiekt warunku filtra reguły LLD definiuje osobne sprawdzenie wykonywane na wartości makra LLD. Ma on następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|macro|string|Makro LLD, na którym ma zostać wykonane sprawdzenie.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Wartość do porównania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operator` is set to "matches regular expression" or "does not match regular expression"|
|formulaid|string|Dowolny unikalny identyfikator używany do odwoływania się do warunku z wyrażenia niestandardowego. Może zawierać wyłącznie wielkie litery. Identyfikator musi zostać zdefiniowany przez użytkownika podczas modyfikowania warunków filtra, ale przy późniejszym pobieraniu zostanie wygenerowany ponownie.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` of [LLD rule filter object](#lld-rule-filter) is set to "custom expression"|
|operator|integer|Operator warunku.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.|

::: notetip
Aby lepiej zrozumieć, jak używać filtrów z różnymi typami wyrażeń, zobacz przykłady na stronach metod [discoveryrule.get](get#retrieving-filter-conditions) i [discoveryrule.create](create#using-a-custom-expression-filter).
:::

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

[comment]: # ({99ea4653-4a2b52b9})
### Ścieżka makra LLD

Ścieżka makra LLD ma następujące właściwości:

|Właściwość|[Type](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|lld\_macro|string|Makro LLD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|path|string|Selektor wartości, która zostanie przypisana do odpowiadającego jej makra.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|

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

[comment]: # ({0769e0f5-14dc55c1})
### Preprocessing reguły LLD

Obiekt preprocessing reguły LLD ma następujące właściwości.

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|type|integer|Typ opcji preprocessing.<br><br>Możliwe wartości:<br>5 - Wyrażenie regularne;<br>11 - XML XPath;<br>12 - JSONPath;<br>14 - Dopasowanie wyrażenia regularnego;<br>15 - Niedopasowanie wyrażenia regularnego;<br>16 - Sprawdzenie błędu w JSON;<br>17 - Sprawdzenie błędu w XML;<br>20 - Odrzuć niezmienione z heartbeat;<br>21 - JavaScript;<br>23 - Prometheus do JSON;<br>24 - CSV do JSON;<br>25 - Zastąp;<br>27 - XML do JSON;<br>28 - Wartość SNMP walk;<br>29 - SNMP walk do JSON;<br>30 - Wartość SNMP get.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|params|string|Dodatkowe parametry używane przez opcję preprocessing. Wiele parametrów jest oddzielonych znakiem nowej linii (\\n).<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Discard unchanged with heartbeat" (20), "JavaScript" (21), "Prometheus to JSON" (23), "CSV to JSON" (24), "Replace" (25), "SNMP walk value" (28), "SNMP walk to JSON" (29) lub "SNMP get value" (30)|
|error\_handler|integer|Typ akcji używany w przypadku niepowodzenia kroku preprocessing.<br><br>Możliwe wartości:<br>0 - Komunikat błędu jest ustawiany przez serwer Zabbix;<br>1 - Odrzuć wartość;<br>2 - Ustaw własną wartość;<br>3 - Ustaw własny komunikat błędu.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Prometheus to JSON" (23), "CSV to JSON" (24), "XML to JSON" (27), "SNMP walk value" (28), "SNMP walk to JSON" (29) lub "SNMP get value" (30)|
|error\_handler\_params|string|Parametry obsługi błędów.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `error_handler` ma wartość "Set custom value" lub "Set custom error message"|

Następujące parametry i obsługi błędów są obsługiwane dla każdego typu preprocessing.

|Typ preprocessing|Nazwa|Parametr 1|Parametr 2|Parametr 3|Obsługiwane obsługi błędów|
|------------------|----|-----------|-----------|-----------|------------------------|
|5|Wyrażenie regularne|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|Dopasowanie wyrażenia regularnego|pattern^1^|<|<|0, 1, 2, 3|
|15|Niedopasowanie wyrażenia regularnego|pattern^1^|<|<|0, 1, 2, 3|
|16|Sprawdzenie błędu w JSON|path^3^|<|<|0, 1, 2, 3|
|17|Sprawdzenie błędu w XML|path^3^|<|<|0, 1, 2, 3|
|20|Odrzuć niezmienione z heartbeat|seconds^4, 5^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|23|Prometheus do JSON|pattern^5, 6^|<|<|0, 1, 2, 3|
|24|CSV do JSON|character^2^|character^2^|0,1|0, 1, 2, 3|
|25|Zastąp|search string^2^|replacement^2^|<|<|
|27|XML do JSON|<|<|<|0, 1, 2, 3|
|28|Wartość SNMP walk|OID^2^|Format:<br>0 - Bez zmian<br>1 - UTF-8 z Hex-STRING<br>2 - MAC z Hex-STRING<br>3 - Liczba całkowita z BITS|<|0, 1, 2, 3|
|29|SNMP walk do JSON^7^|Field name^2^|OID prefix^2^|Format:<br>0 - Bez zmian<br>1 - UTF-8 z Hex-STRING<br>2 - MAC z Hex-STRING<br>3 - Liczba całkowita z BITS|0, 1, 2, 3|
|30|Wartość SNMP get|Format:<br>1 - UTF-8 z Hex-STRING<br>2 - MAC z Hex-STRING<br>3 - Liczba całkowita z BITS|<|<|0, 1, 2, 3|

^1^ wyrażenie regularne<br>
^2^ ciąg znaków<br>
^3^ JSONPath lub XML XPath<br>
^4^ dodatnia liczba całkowita (z obsługą sufiksów czasu, np. 30s, 1m, 2h,
1d)<br>
^5^ makro użytkownika<br>
^6^ wzorzec Prometheus zgodny ze składnią:
`<metric name>{<label name>="<label value>", ...} == <value>`. Każdy
element wzorca Prometheus (metryka, nazwa etykiety, wartość etykiety i wartość metryki)
może być makrem użytkownika.<br>
^7^ Obsługuje wiele rekordów "Field name,OID prefix,Format records" oddzielonych znakiem nowej linii.

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

[comment]: # ({f2f34ac6-2f32e5f0})
### Nadpisy reguł LLD

Obiekt nadpisywania reguł LLD definiuje zestaw reguł (filtry, warunki i operacje), które są używane do nadpisywania właściwości różnych obiektów prototypów. Ma on następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|name|string|Unikalna nazwa nadpisania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|step|integer|Unikalny numer kolejności nadpisania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|stop|integer|Zatrzymaj przetwarzanie kolejnych nadpisań, jeśli nastąpi dopasowanie.<br><br>Possible values:<br>0 - *(default)* nie zatrzymuj przetwarzania nadpisań;<br>1 - zatrzymaj przetwarzanie nadpisań, jeśli filtr pasuje.|
|filter|object|Filtr nadpisania.|
|operations|object/array|Operacje nadpisania.|

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

[comment]: # ({67737988-573b52c4})
#### Filtr nadpisywania reguły LLD

Obiekt filtra nadpisywania reguły LLD definiuje zestaw warunków, które jeśli
dopasują wykryty obiekt, zostanie zastosowane nadpisanie. Ma on
następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|conditions|object/array|Zestaw [warunków filtra nadpisywania](#lld-rule-override-filter-condition) używanych do dopasowywania wykrytych obiektów. Warunki zostaną posortowane zgodnie z kolejnością ich umieszczenia we wzorze.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|evaltype|integer|[Metoda oceny](/manual/discovery/low_level_discovery#override) warunków filtra nadpisywania.<br><br>Możliwe wartości:<br>0 - And/Or;<br>1 - And;<br>2 - Or;<br>3 - Wyrażenie niestandardowe.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|eval\_formula|string|Wygenerowane wyrażenie, które będzie używane do oceny warunków filtra nadpisywania. Wyrażenie zawiera identyfikatory odwołujące się do konkretnych warunków filtra nadpisywania za pomocą ich `formulaid`. Wartość `eval_formula` jest równa wartości `formula` dla filtrów z wyrażeniem niestandardowym.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|formula|string|Zdefiniowane przez użytkownika wyrażenie używane do oceny warunków filtrów nadpisywania z wyrażeniem niestandardowym. Wyrażenie musi zawierać identyfikatory odwołujące się do konkretnych warunków filtra nadpisywania za pomocą ich `formulaid`. Identyfikatory użyte w wyrażeniu muszą dokładnie odpowiadać tym zdefiniowanym w warunkach filtra nadpisywania: żaden warunek nie może pozostać nieużyty ani pominięty.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required* jeśli `evaltype` jest ustawione na "custom expression"|

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

[comment]: # ({a2dc636e-e47f6c6a})
##### Warunek filtra nadpisania reguły LLD

Obiekt warunku filtra nadpisania reguły LLD definiuje osobne sprawdzenie
wykonywane na wartości makra LLD. Ma on następujące
właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|macro|string|Makro LLD, na którym ma zostać wykonane sprawdzenie.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Wartość do porównania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* jeśli `operator` jest ustawiony na "matches regular expression" lub "does not match regular expression"|
|formulaid|string|Dowolny unikalny identyfikator używany do odwoływania się do warunku z wyrażenia niestandardowego. Może zawierać wyłącznie wielkie litery. Identyfikator musi zostać zdefiniowany przez użytkownika podczas modyfikowania warunków filtra, ale zostanie wygenerowany ponownie przy późniejszym pobraniu. <br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* jeśli `evaltype` obiektu [LLD rule override filter object](#lld-rule-override-filter) jest ustawiony na "custom expression"|
|operator|integer|Operator warunku.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.|

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

[comment]: # ({02af08bb-e7b08f3c})
#### Operacja nadpisania reguły LLD

Operacja nadpisania reguły LLD jest kombinacją warunków i akcji
wykonywanych na obiekcie prototypu. Ma następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|operationobject|integer|Typ wykrytego obiektu, na którym ma zostać wykonana akcja.<br><br>Possible values:<br>0 - Prototyp pozycji;<br>1 - Prototyp wyzwalacza;<br>2 - Prototyp wykresu;<br>3 - Prototyp hosta;<br>4 - Prototyp wykrywania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|operator|integer|Operator [warunku nadpisania](/manual/discovery/low_level_discovery#override).<br><br>Possible values:<br>0 - *(default)* równa się;<br>1 - nie równa się;<br>2 - zawiera;<br>3 - nie zawiera;<br>8 - pasuje do;<br>9 - nie pasuje do.|
|value|string|Wzorzec dopasowania nazwy pozycji, wyzwalacza, wykresu lub prototypu hosta, zależnie od wybranego obiektu.|
|opstatus|object|Obiekt statusu operacji nadpisania dla obiektów typu pozycja, wyzwalacz i prototyp hosta.|
|opdiscover|object|Obiekt statusu wykrywania operacji nadpisania (wszystkie typy obiektów).|
|opperiod|object|Obiekt okresu operacji nadpisania (interwału aktualizacji) dla obiektu typu prototyp pozycji.|
|ophistory|object|Obiekt historii operacji nadpisania dla obiektu typu prototyp pozycji.|
|optrends|object|Obiekt trendów operacji nadpisania dla obiektu typu prototyp pozycji.|
|opseverity|object|Obiekt ważności operacji nadpisania dla obiektu typu prototyp wyzwalacza.|
|optag|object/array|Obiekt tagu operacji nadpisania dla obiektów typu wyzwalacz i prototyp hosta.|
|optemplate|object/array|Obiekt szablonu operacji nadpisania dla obiektu typu prototyp hosta.|
|opinventory|object|Obiekt inwentarza operacji nadpisania dla obiektu typu prototyp hosta.|

[comment]: # ({/02af08bb-e7b08f3c})

[comment]: # ({3d3c516a-52d3b579})
##### Status operacji nadpisania reguły LLD

Status operacji nadpisania reguły LLD ustawiony dla wykrytego obiektu. Ma on następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|status|integer|Nadpisz status dla wybranego obiektu.<br><br>Możliwe wartości:<br>0 - Utwórz włączone;<br>1 - Utwórz wyłączone.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({9cdd5143-ff620350})
##### Operacja nadpisania reguły LLD discover

Operacja nadpisania reguły LLD discover status ustawiony na discovered
obiekt. Ma następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|discover|integer|Nadpisz status discover dla wybranego obiektu.<br><br>Możliwe wartości:<br>0 - Tak, kontynuuj wykrywanie obiektów;<br>1 - Nie, nowe obiekty nie będą wykrywane, a istniejące zostaną oznaczone jako utracone.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({b3bef187-6e469c1b})
##### Okres operacji nadpisania reguły LLD

Okres operacji nadpisania reguły LLD jest wartością interwału aktualizacji ustawianą dla odkrytej pozycji.
Ma następujące właściwości:

|Właściwość|[Type](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|delay|string|Nadpisuje interwał aktualizacji prototypu pozycji.<br><br>Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 1m, 2h, 1d) oraz opcjonalnie jeden lub więcej [interwałów niestandardowych](/manual/config/items/item/custom_intervals), wszystkie oddzielone średnikami. Interwały niestandardowe mogą stanowić mieszankę interwałów elastycznych i harmonogramowanych.<br><br>Akceptuje makra użytkownika lub makra LLD. Jeśli są używane, wartość musi być pojedynczym makrem. Wiele makr lub makra zmieszane z tekstem nie są obsługiwane. Interwały elastyczne mogą być zapisane jako dwa makra oddzielone ukośnikiem (np. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Przykład:<br>`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({28d8eca2-ff97489f})
##### Historia operacji nadpisania reguły LLD

Wartość historii operacji nadpisania reguły LLD ustawiana dla wykrytej
pozycji. Ma następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|history|string|Nadpisuje historię prototypu pozycji, czyli jednostkę czasu określającą, jak długo dane historyczne mają być przechowywane. Akceptuje również makro użytkownika i makro LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({a1ea1935-10b52601})
##### Trendy operacji nadpisania reguły LLD

Wartość trendów operacji nadpisania reguły LLD, która jest ustawiana dla wykrytej pozycji.
Ma następujące właściwości:

|Właściwość|[Type](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|trends|string|Nadpisuje trendy prototypu pozycji, czyli jednostkę czasu określającą, jak długo dane trendów mają być przechowywane. Akceptuje również makro użytkownika i makro LLD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({e551a258-991f3bdc})
##### Nadrzędna operacja nadpisania poziomu ważności reguły LLD

Wartość poziomu ważności operacji nadpisania reguły LLD, która jest ustawiana dla wykrytego wyzwalacza. Ma następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|severity|integer|Nadpisuje poziom ważności prototypu wyzwalacza.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* nie sklasyfikowano;<br>1 - informacja;<br>2 - ostrzeżenie;<br>3 - średni;<br>4 - wysoki;<br>5 - katastrofa.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({71613716-0693b8f3})
##### Znacznik operacji nadpisania reguły LLD

Obiekt znacznika operacji nadpisania reguły LLD zawiera nazwę znacznika i wartość, które są ustawiane dla wykrytego obiektu. Ma on następujące właściwości:

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|--|
|tag|string|Nowa nazwa znacznika.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|value|string|Nowa wartość znacznika.|

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

[comment]: # ({0e075e84-5eebc05a})
##### Szablon operacji nadpisania reguły LLD

Obiekt szablonu operacji nadpisania reguły LLD, który jest powiązany z wykrytym hostem. Ma następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|templateid|ID|Nadpisuje szablon połączonych szablonów prototypu hosta.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

[comment]: # ({e26c68ed-9c5cc3d1})
##### Inwentarz operacji nadpisania reguły LLD

Wartość trybu inwentarza operacji nadpisania reguły LLD, która jest ustawiana dla wykrytego hosta. Ma ona następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|inventory\_mode|integer|Nadpisuje tryb inwentarza prototypu hosta.<br><br>Możliwe wartości:<br>-1 - wyłączone;<br>0 - *(domyślnie)* ręczny;<br>1 - automatyczny.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|

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