[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]: # ({0268e8c8-c17fa830})
### Reguła LLD

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID reguły LLD.<br><br>[Property behavior](/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 jedną lub więcej [niestandardowych interwałów](/manual/config/items/item/custom_intervals), wszystkie oddzielone średnikami. Niestandardowe interwały mogą być mieszanką 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 połączone 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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "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` ma wartość "Zabbix agent (active)" (7) i `key_` nie zawiera "mqtt.get"|
|hostid|ID|ID hosta, do którego należy reguła LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *stałe*<br>- *wymagane* dla operacji tworzenia|
|interfaceid|ID|ID interfejsu hosta reguły LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli reguła LLD należy do hosta i `type` ma wartość "Zabbix agent", "IPMI agent", "JMX agent" lub "SNMP agent"<br>- *obsługiwane* jeśli reguła LLD należy do hosta i `type` ma wartość "Simple check", "External check", "SSH agent", "TELNET agent" lub "HTTP agent"|
|key\_|string|Klucz reguły LLD.<br><br>[Property behavior](/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>[Property behavior](/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 - 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>- *wymagane* dla operacji tworzenia<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|url|string|Łańcuch URL.<br>Obsługuje makra użytkownika, {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>- *wymagane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|allow\_traps|integer|Pozwala na wypełnianie wartości podobnie jak w przypadku 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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"|
|authtype|integer|Metoda uwierzytelniania.<br><br>Możliwe wartości, jeśli `type` ma wartość "SSH agent":<br>0 - *(domyślnie)* hasło;<br>1 - klucz publiczny.<br><br>Możliwe wartości, jeśli `type` ma wartość "HTTP agent":<br>0 - *(domyślnie)* brak;<br>1 - basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "SSH agent" lub "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` ma wartość "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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|follow\_redirects|integer|Podążaj za przekierowaniami odpowiedzi podczas pobierania danych.<br><br>Możliwe wartości:<br>0 - Nie podążaj za przekierowaniami;<br>1 - *(domyślnie)* Podążaj za przekierowaniami.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|http\_proxy|string|Łańcuch połączenia proxy HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|ipmi\_sensor|string|Czujnik IPMI.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "IPMI agent" i `key_` nie ma wartości "ipmi.get"<br>- *obsługiwane* jeśli `type` ma wartość "IPMI agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|jmx\_endpoint|string|Niestandardowy łańcuch połączenia agenta JMX.<br><br>Domyślnie: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "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 czasu życia;<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 czasu życia;<br>1 - Nie wyłączaj;<br>2 - *(domyślnie)* Wyłącz natychmiast.|
|master\_itemid|ID|ID pozycji nadrzędnej.<br>Dozwolona jest rekurencja do 3 pozycji zależnych oraz maksymalna liczba pozycji zależnych równa 999.<br>Reguła wykrywania nie może być pozycją nadrzędną dla innej reguły wykrywania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "Dependent item"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|output\_format|integer|Czy odpowiedź ma zostać przekonwertowana do JSON.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Zapisz surowe dane;<br>1 - Konwertuj do JSON.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|params|string|Dodatkowe parametry zależnie od typu reguły LLD:<br>- wykonywany skrypt dla reguł LLD SSH i Telnet;<br>- zapytanie SQL dla reguł LLD monitorowania bazy danych;<br>- formuła dla obliczanych reguł LLD;<br>- skrypt dla reguł LLD typu script i browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "Database monitor", "SSH agent", "TELNET agent", "Script" lub "Browser"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` ma wartość "Script" lub "Browser")|
|parameters|object/array|Dodatkowe parametry, jeśli `type` ma wartość "Script" lub "Browser".<br>Tablica obiektów z właściwościami `name` i `value`, gdzie `name` musi być unikalne.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "Script" lub "Browser"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|password|string|Hasło do uwierzytelniania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "JMX agent" i `username` jest ustawione<br>- *obsługiwane* jeśli `type` ma wartość "Simple check", "Database monitor", "SSH agent", "TELNET agent" lub "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` ma wartość "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)* Dane surowe;<br>2 - Dane JSON;<br>3 - Dane XML.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|posts|string|Dane treści żądania HTTP(S).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "HTTP agent" i `post_type` ma wartość "JSON data" lub "XML data"<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent" i `post_type` ma wartość "Raw data"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|privatekey|string|Nazwa pliku klucza prywatnego.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "SSH agent" i `authtype` ma wartość "public key"|
|publickey|string|Nazwa pliku klucza publicznego.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "SSH agent" i `authtype` ma wartość "public key"|
|query\_fields|array|Tablica [pól zapytania](#http-query-field), które zostaną wysłane podczas wykonywania żądania HTTP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|retrieve\_mode|integer|Która część odpowiedzi ma zostać zapisana.<br><br>Możliwe wartości, jeśli `request_method` ma wartość "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` ma wartość "HEAD":<br>1 - Nagłówki.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|snmp\_oid|string|OID SNMP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "SNMP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|ssl\_cert\_file|string|Ścieżka do publicznego pliku klucza SSL.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|ssl\_key\_file|string|Ścieżka do prywatnego pliku klucza SSL.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|ssl\_key\_password|string|Hasło do pliku klucza SSL.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "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ługiwany.<br><br>[Property behavior](/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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|templateid|ID|ID nadrzędnego szablonu reguły LLD.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|timeout|string|Limit czasu żądania pobierania 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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "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>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "Zabbix trapper", lub jeśli `type` ma wartość "HTTP agent" i `allow_traps` ma wartość "Allow to accept incoming data"|
|username|string|Nazwa użytkownika do uwierzytelniania.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "SSH agent", "TELNET agent", lub jeśli `type` ma wartość "JMX agent" i `password` jest ustawione<br>- *obsługiwane* jeśli `type` ma wartość "Simple check", "Database monitor" lub "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` ma wartość "HTTP agent")|
|uuid|string|Uniwersalny unikalny identyfikator, używany do powiązania importowanych reguł LLD z już istniejącymi. Generowany automatycznie, jeśli nie zostanie podany.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli reguła LLD należy do szablonu|
|verify\_host|integer|Czy sprawdzać, czy nazwa hosta dla połączenia zgadza się z nazwą w certyfikacie hosta.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Nie sprawdzaj;<br>1 - Sprawdzaj.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|
|verify\_peer|integer|Czy sprawdzać, czy certyfikat hosta jest autentyczny.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Nie sprawdzaj;<br>1 - Sprawdzaj.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `type` ma wartość "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych|

[comment]: # ({/0268e8c8-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 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 warunków filtra](/manual/discovery/low_level_discovery#filter).<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|Wyrażenie zdefiniowane przez użytkownika, 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]: # ({d0e9011a-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:

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|macro|string|Makro LLD, na którym ma zostać wykonane sprawdzenie.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|value|string|Wartość do porównania.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* 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 przy późniejszym pobieraniu zostanie wygenerowany ponownie.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `evaltype` obiektu [LLD rule filter object](#lld-rule-filter) jest ustawiony na "custom expression"|
|operator|integer|Operator warunku.<br><br>Możliwe wartości:<br>8 - *(domyślnie)* 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]: # ({/d0e9011a-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.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|Typ opcji preprocessing.<br><br>Possible values:<br>5 - Wyrażenie regularne;<br>11 - XML XPath;<br>12 - JSONPath;<br>14 - Dopasowuje wyrażenie regularne;<br>15 - Nie dopasowuje wyrażenia regularnego;<br>16 - Sprawdź błąd w JSON;<br>17 - Sprawdź błąd w XML;<br>20 - Odrzuć niezmienione z heartbeat;<br>21 - JavaScript;<br>23 - Prometheus do JSON;<br>24 - CSV do JSON;<br>25 - Zamień;<br>27 - XML do JSON;<br>28 - Wartość SNMP walk;<br>29 - SNMP walk do JSON;<br>30 - Wartość SNMP get.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|params|string|Dodatkowe parametry używane przez opcję preprocessing. Wiele parametrów jest oddzielonych znakiem nowej linii (\\n).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* jeśli `type` jest ustawione na "Wyrażenie regularne" (5), "XML XPath" (11), "JSONPath" (12), "Dopasowuje wyrażenie regularne" (14), "Nie dopasowuje wyrażenia regularnego" (15), "Sprawdź błąd w JSON" (16), "Sprawdź błąd w XML" (17), "Odrzuć niezmienione z heartbeat" (20), "JavaScript" (21), "Prometheus do JSON" (23), "CSV do JSON" (24), "Zamień" (25), "Wartość SNMP walk" (28), "SNMP walk do JSON" (29) lub "Wartość SNMP get" (30)|
|error\_handler|integer|Typ akcji używany w przypadku niepowodzenia kroku preprocessing.<br><br>Possible values:<br>0 - Komunikat błędu jest ustawiany przez serwer Zabbix;<br>1 - Odrzuć wartość;<br>2 - Ustaw wartość niestandardową;<br>3 - Ustaw niestandardowy komunikat błędu.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* jeśli `type` jest ustawione na "Wyrażenie regularne" (5), "XML XPath" (11), "JSONPath" (12), "Dopasowuje wyrażenie regularne" (14), "Nie dopasowuje wyrażenia regularnego" (15), "Sprawdź błąd w JSON" (16), "Sprawdź błąd w XML" (17), "Prometheus do JSON" (23), "CSV do JSON" (24), "XML do JSON" (27), "Wartość SNMP walk" (28), "SNMP walk do JSON" (29) lub "Wartość SNMP get" (30)|
|error\_handler\_params|string|Parametry obsługi błędów.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* jeśli `error_handler` jest ustawione na "Ustaw wartość niestandardową" lub "Ustaw niestandardowy komunikat błędu"|

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

|Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers|
|------------------|----|-----------|-----------|-----------|------------------------|
|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|Dopasowuje wyrażenie regularne|pattern^1^|<|<|0, 1, 2, 3|
|15|Nie dopasowuje wyrażenia regularnego|pattern^1^|<|<|0, 1, 2, 3|
|16|Sprawdź błąd w JSON|path^3^|<|<|0, 1, 2, 3|
|17|Sprawdź błąd 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|Zamień|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 - Integer 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 - Integer 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 - Integer 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 (nazwa metryki, 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" 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 pasuje.<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 po dopasowaniu do wykrytego obiektu powodują zastosowanie nadpisania. 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|Wyrażenie zdefiniowane przez użytkownika, 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 osobny test
wykonywany 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ć wykonany test.<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 override filter object](#lld-rule-override-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.|

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

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

Operacja nadpisania reguły LLD jest kombinacją warunków i działań
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 - 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|Operator warunku nadpisania [operator](/manual/discovery/low_level_discovery#override).<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>8 - matches;<br>9 - does not match.|
|value|string|Wzorzec dopasowania nazwy prototypu pozycji, wyzwalacza, wykresu lub hosta, zależnie od wybranego obiektu.|
|opstatus|object|Obiekt statusu operacji nadpisania dla obiektów typu item, trigger i host prototype.|
|opdiscover|object|Obiekt statusu wykrywania operacji nadpisania (wszystkie typy obiektów).|
|opperiod|object|Obiekt okresu operacji nadpisania (interwału aktualizacji) dla obiektu typu item prototype.|
|ophistory|object|Obiekt historii operacji nadpisania dla obiektu typu item prototype.|
|optrends|object|Obiekt trendów operacji nadpisania dla obiektu typu item prototype.|
|opseverity|object|Obiekt ważności operacji nadpisania dla obiektu typu trigger prototype.|
|optag|object/array|Obiekt tagu operacji nadpisania dla obiektów typu trigger i host prototype.|
|optemplate|object/array|Obiekt szablonu operacji nadpisania dla obiektu typu host prototype.|
|opinventory|object|Obiekt inwentarza operacji nadpisania dla obiektu typu host prototype.|

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

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

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|status|integer|Zastąp 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

Status operacji nadpisania reguły LLD discover, który jest ustawiony dla wykrytego obiektu. 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>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

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

Okres operacji nadpisania reguły LLD to wartość interwału aktualizacji ustawiana dla wykrytej pozycji.
Ma następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|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ą być kombinacją interwałów elastycznych i harmonogramowych.<br><br>Akceptuje makra użytkownika lub makra LLD (obsługa makr LLD przywrócona w Zabbix 7.0.27). Jeśli są używane, wartość musi być pojedynczym makrem. Nie są obsługiwane wiele makr ani makra połączone z tekstem. Interwały elastyczne można zapisać 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*|

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

[comment]: # ({a8b2ff35-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 (obsługa makr LLD została przywrócona w Zabbix 7.0.27).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|

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

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

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

|Właściwość|[Typ](/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 powinny być przechowywane. Akceptuje również makro użytkownika i makro LLD (obsługa makr LLD została przywrócona w Zabbix 7.0.27).<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|

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

[comment]: # ({e551a258-991f3bdc})
##### Nadpisanie poziomu ważności operacji reguły LLD

Wartość poziomu ważności operacji nadpisania reguły LLD, która jest ustawiana dla wykrytego wyzwalacza. Ma ona 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]: # ({427bdb05-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 następujące właściwości:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nowa nazwa znacznika. Akceptuje również makro użytkownika i makro LLD.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Nowa wartość znacznika. Akceptuje również makro użytkownika i makro LLD.|

[comment]: # ({/427bdb05-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 prototypu hosta powiązanych szablonów.<br><br>[Zachowanie właściwości](/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:

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|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})
