[comment]: # aside:1

[comment]: # ({d1f57367-6bb9f60f})
# Obiekt pozycji

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

[comment]: # ({/d1f57367-6bb9f60f})

[comment]: # ({4401882e-385ac8b5})
### Pozycja

::: noteclassic
Pozycji webowych nie można bezpośrednio tworzyć, aktualizować ani usuwać za pomocą API Zabbixa.
:::

Obiekt pozycji ma następujące właściwości.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*<br>- *wymagane* dla operacji aktualizacji|
|delay|string|Interwał aktualizacji pozycji.<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ć mieszanką interwałów elastycznych i harmonogramowych.<br><br>Akceptuje makra użytkownika. 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>[Property behavior](/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), "Calculated" (15), "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 lub szablonu, do którego należy pozycja.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *stałe*<br>- *wymagane* dla operacji tworzenia|
|interfaceid|ID|ID interfejsu hosta pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli pozycja należy do hosta i `type` jest ustawione na "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap" lub "SNMP agent"<br>- *obsługiwane* jeśli pozycja należy do hosta i `type` jest ustawione na "Simple check", "External check", "SSH agent", "TELNET agent" lub "HTTP agent"<br>- *tylko do odczytu* dla obiektów wykrytych|
|key\_|string|Klucz pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|name|string|Nazwa pozycji.<br>Obsługuje makra użytkownika.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|name\_resolved|string|Nazwa pozycji z rozwiniętymi makrami użytkownika.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|type|integer|Typ pozycji.<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>9 - Web item;<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>15 - Calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<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 lub wykrytych|
|url|string|Adres 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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|value\_type|integer|Typ informacji pozycji.<br><br>Możliwe wartości:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text;<br>5 - binary.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|allow\_traps|integer|Pozwala na wypełnianie wartości podobnie jak w przypadku pozycji trapper.<br><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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów wykrytych|
|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>[Property behavior](/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") lub wykrytych|
|description|string|Opis pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu* dla obiektów wykrytych|
|error|string|Tekst błędu, jeśli występują problemy z aktualizacją wartości pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|flags|integer|Pochodzenie pozycji.<br><br>Możliwe wartości:<br>0 - zwykła pozycja;<br>4 - pozycja wykryta.<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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|history|string|Jednostka czasu określająca, jak długo mają być przechowywane dane historii.<br>Akceptuje również makro użytkownika.<br><br>Domyślnie: 31d.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu* dla obiektów wykrytych|
|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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|inventory\_link|integer|ID pola inwentarza hosta, które jest wypełniane przez pozycję.<br><br>Listę obsługiwanych pól inwentarza hosta i ich identyfikatorów można znaleźć na [stronie inwentarza hosta](/manual/api/reference/host/object#host-inventory).<br><br>Domyślnie: 0.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `value_type` jest ustawione na "numeric float", "character", "numeric unsigned" lub "text"<br>- *tylko do odczytu* dla obiektów wykrytych|
|ipmi\_sensor|string|Czujnik IPMI.<br><br>[Property behavior](/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 lub wykrytych|
|jmx\_endpoint|string|Niestandardowy ciąg połączenia agenta JMX.<br><br>Wartość domyślna: 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` jest ustawione na "JMX agent"<br>- *tylko do odczytu* dla obiektów wykrytych|
|lastclock|timestamp|Czas ostatniej aktualizacji wartości pozycji.<br><br>Domyślnie wyświetlane są tylko wartości mieszczące się w ostatnich 24 godzinach. Ten okres można wydłużyć, zmieniając wartość parametru *Maksymalny okres wyświetlania historii* w sekcji menu *[Administracja → Ogólne](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|lastns|integer|Nanosekundy ostatniej aktualizacji wartości pozycji.<br><br>Domyślnie wyświetlane są tylko wartości mieszczące się w ostatnich 24 godzinach. Ten okres można wydłużyć, zmieniając wartość parametru *Maksymalny okres wyświetlania historii* w sekcji menu *[Administracja → Ogólne](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|lastvalue|string|Ostatnia wartość pozycji.<br><br>Domyślnie wyświetlane są tylko wartości mieszczące się w ostatnich 24 godzinach. Ten okres można wydłużyć, zmieniając wartość parametru *Maksymalny okres wyświetlania historii* w sekcji menu *[Administracja → Ogólne](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|logtimefmt|string|Format czasu w wpisach dziennika.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `value_type` jest ustawione na "log"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|master\_itemid|ID|ID pozycji nadrzędnej.<br>Dozwolona jest rekurencja do 3 pozycji zależnych oraz maksymalna liczba pozycji zależnych równa 29999.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` jest ustawione na "Dependent item"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|output\_format|integer|Czy odpowiedź ma zostać przekonwertowana do JSON.<br><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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|params|string|Dodatkowe parametry zależne od typu pozycji:<br>- wykonywany skrypt dla pozycji SSH agent i TELNET agent;<br>- zapytanie SQL dla pozycji database monitor;<br>- formuła dla pozycji calculated;<br>- skrypt dla pozycji script i browser.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` jest ustawione na "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script" lub "Browser"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` jest ustawione na "Script" lub "Browser") lub wykrytych|
|parameters|object/array|Dodatkowe parametry jeśli `type` jest ustawione na "Script" lub "Browser". Tablica obiektów z właściwościami `name` i `value`, przy czym `name` musi być unikalne.<br><br>[Property behavior](/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 lub wykrytych|
|password|string|Hasło do uwierzytelniania.<br><br>[Property behavior](/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", "SSH agent", "TELNET agent", "Database monitor" lub "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych (jeśli `type` jest ustawione na "HTTP agent") lub wykrytych|
|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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|posts|string|Dane treści żądania HTTP(S).<br><br>[Property behavior](/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 lub wykrytych|
|prevvalue|string|Poprzednia wartość pozycji.<br><br>Domyślnie wyświetlane są tylko wartości mieszczące się w ostatnich 24 godzinach. Ten okres można wydłużyć, zmieniając wartość parametru *Maksymalny okres wyświetlania historii* w sekcji menu *[Administracja → Ogólne](/manual/web_interface/frontend_sections/administration/general#gui)*.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|privatekey|string|Nazwa pliku klucza prywatnego.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` jest ustawione na "SSH agent" i `authtype` jest ustawione na "public key"<br>- *tylko do odczytu* dla obiektów wykrytych|
|publickey|string|Nazwa pliku klucza publicznego.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` jest ustawione na "SSH agent" i `authtype` jest ustawione na "public key"<br>- *tylko do odczytu* dla obiektów wykrytych|
|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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|retrieve\_mode|integer|Która część odpowiedzi ma 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>[Property behavior](/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 lub wykrytych|
|snmp\_oid|string|OID SNMP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` jest ustawione na "SNMP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|ssl\_cert\_file|string|Ścieżka do pliku publicznego klucza SSL.<br><br>[Property behavior](/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 lub wykrytych|
|ssl\_key\_file|string|Ścieżka do pliku prywatnego klucza SSL.<br><br>[Property behavior](/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 lub wykrytych|
|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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|state|integer|Stan pozycji.<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 pozycji.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* pozycja włączona;<br>1 - pozycja wyłączona.|
|status\_codes|string|Zakresy wymaganych kodów statusu HTTP, oddzielone przecinkami.<br>Obsługuje również makra użytkownika jako część listy oddzielonej 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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|templateid|ID|ID nadrzędnego elementu szablonu pozycji.<br><br>*Wskazówka*: Użyj właściwości `hostid`, aby określić szablon, do którego należy pozycja.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|timeout|string|Limit czasu oczekiwania na żądanie 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` 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 i wykrytych|
|trapper\_hosts|string|Dozwolone hosty.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *readonly* dla obiektów wykrytych<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"|
|trends|string|Jednostka czasu określająca, jak długo mają być przechowywane dane trendów.<br>Akceptuje również makro użytkownika.<br><br>Domyślnie: 365d.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `value_type` jest ustawione na "numeric float" lub "numeric unsigned"<br>- *tylko do odczytu* dla obiektów wykrytych|
|units|string|Jednostki wartości.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `value_type` jest ustawione na "numeric float" lub "numeric unsigned"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|username|string|Nazwa użytkownika do uwierzytelniania.<br><br>[Property behavior](/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") lub wykrytych|
|uuid|string|Uniwersalny unikalny identyfikator, używany do powiązania importowanej pozycji 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 pozycja należy do szablonu|
|valuemapid|ID|ID powiązanej mapy wartości.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obsługiwane* jeśli `value_type` jest ustawione na "numeric float", "character" lub "numeric unsigned"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|verify\_host|integer|Czy należy 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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|
|verify\_peer|integer|Czy należy 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` jest ustawione na "HTTP agent"<br>- *tylko do odczytu* dla obiektów dziedziczonych lub wykrytych|

[comment]: # ({/4401882e-385ac8b5})

[comment]: # ({ab5307fa-7efc456e})
#### 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-7efc456e})

[comment]: # ({5b4177f3-ee8852f1})
#### 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ść|[Type](/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-ee8852f1})

[comment]: # ({c9a1b21e-c1b98afa})
### Tag pozycji

Obiekt tagu pozycji ma następujące właściwości.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nazwa tagu pozycji.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Wartość tagu pozycji.|

[comment]: # ({/c9a1b21e-c1b98afa})

[comment]: # ({eed27a12-2169bb78})
### Przetwarzanie wstępne pozycji

Obiekt przetwarzania wstępnego pozycji ma następujące właściwości.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|Typ opcji przetwarzania wstępnego.<br><br>Możliwe wartości:<br>1 - Niestandardowy mnożnik;<br>2 - Przytnij z prawej;<br>3 - Przytnij z lewej;<br>4 - Przytnij;<br>5 - Wyrażenie regularne;<br>6 - Wartość logiczna na dziesiętną;<br>7 - Ósemkowa na dziesiętną;<br>8 - Szesnastkowa na dziesiętną;<br>9 - Prosta zmiana;<br>10 - Zmiana na sekundę;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - W zakresie;<br>14 - Pasuje do wyrażenia regularnego;<br>15 - Nie pasuje do wyrażenia regularnego;<br>16 - Sprawdź błąd w JSON;<br>17 - Sprawdź błąd w XML;<br>18 - Sprawdź błąd przy użyciu wyrażenia regularnego;<br>19 - Odrzuć niezmienione;<br>20 - Odrzuć niezmienione z heartbeat;<br>21 - JavaScript;<br>22 - Wzorzec Prometheus;<br>23 - Prometheus do JSON;<br>24 - CSV do JSON;<br>25 - Zastąp;<br>26 - Sprawdź nieobsługiwane;<br>27 - XML do JSON;<br>28 - Wartość z przebiegu 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ę przetwarzania wstępnego.<br>Wiele parametrów jest oddzielonych znakiem nowej linii (\\n).<br><br>Jeśli `type` ma wartość "Check unsupported", parametry mają składnię `<scope>[\n<pattern>]`, gdzie *pattern* jest wyrażeniem regularnym, a *scope* jest jednym z:<br>-1 - dopasuj dowolny błąd;<br>\ 0 - sprawdź, czy komunikat błędu pasuje do *pattern*;<br>\ 1 - sprawdź, czy komunikat błędu nie pasuje do *pattern*.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "Custom multiplier" (1), "Right trim" (2), "Left trim" (3), "Trim" (4), "Regular expression" (5), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Discard unchanged with heartbeat" (20), "JavaScript" (21), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Replace" (25), Check unsupported (26), "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 przetwarzania wstępnego.<br><br>Możliwe wartości:<br>0 - Komunikat błędu jest ustawiany przez serwer Zabbix;<br>1 - Odrzuć wartość;<br>2 - Ustaw niestandardową wartość;<br>3 - Ustaw niestandardowy komunikat błędu.<br><br>Możliwe wartości, jeśli `type` ma wartość "Check unsupported":<br>1 - Odrzuć wartość;<br>2 - Ustaw niestandardową wartość;<br>3 - Ustaw niestandardowy komunikat błędu.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `type` ma wartość "Custom multiplier" (1), "Regular expression" (5), "Boolean to decimal" (6), "Octal to decimal" (7), "Hexadecimal to decimal" (8), "Simple change" (9), "Change per second" (10), "XML XPath" (11), "JSONPath" (12), "In range" (13), "Matches regular expression" (14), "Does not match regular expression" (15), "Check for error in JSON" (16), "Check for error in XML" (17), "Check for error using regular expression" (18), "Prometheus pattern" (22), "Prometheus to JSON" (23), "CSV to JSON" (24), "Check unsupported" (26), "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 przetwarzania wstępnego.

|Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers|
|------------------|----|-----------|-----------|-----------|------------------------|
|1|Custom multiplier|number^1, 6^|<|<|0, 1, 2, 3|
|2|Right trim|list of characters^2^|<|<|<|
|3|Left trim|list of characters^2^|<|<|<|
|4|Trim|list of characters^2^|<|<|<|
|5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3|
|6|Boolean to decimal|<|<|<|0, 1, 2, 3|
|7|Octal to decimal|<|<|<|0, 1, 2, 3|
|8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3|
|9|Simple change|<|<|<|0, 1, 2, 3|
|10|Change per second|<|<|<|0, 1, 2, 3|
|11|XML XPath|path^4^|<|<|0, 1, 2, 3|
|12|JSONPath|path^4^|<|<|0, 1, 2, 3|
|13|In range|min^1, 6^|max^1, 6^|<|0, 1, 2, 3|
|14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3|
|15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3|
|16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3|
|17|Check for error in XML|path^4^|<|<|0, 1, 2, 3|
|18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3|
|19|Discard unchanged|<|<|<|<|
|20|Discard unchanged with heartbeat|seconds^5, 6^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|22|Prometheus pattern|pattern^6, 7^|`value`, `label`, `function`|output^8, 9^|0, 1, 2, 3|
|23|Prometheus to JSON|pattern^6, 7^|<|<|0, 1, 2, 3|
|24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3|
|25|Replace|search string^2^|replacement^2^|<|<|
|26|Check unsupported|scope^1^|pattern^3, 6^|<|1, 2, 3|
|27|XML to JSON|<|<|<|0, 1, 2, 3|
|28|SNMP walk value|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 to JSON^10^|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|SNMP get value|Format:<br>1 - UTF-8 z Hex-STRING<br>2 - MAC z Hex-STRING<br>3 - Integer z BITS|<|<|0, 1, 2, 3|

^1^ liczba zmiennoprzecinkowa (liczby całkowite są niejawnie konwertowane do wartości typu float)<br>
^2^ ciąg znaków<br>
^3^ wyrażenie regularne<br>
^4^ JSONPath lub XML XPath<br>
^5^ dodatnia liczba całkowita (z obsługą sufiksów czasu, np. 30s, 1m, 2h,
1d)<br>
^6^ makro użytkownika<br>
^7^ 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>
^8^ wynik Prometheus zgodny ze składnią: `<label name>` (może być makrem użytkownika), jeśli jako drugi parametr wybrano `label`.<br>
^9^ jedna z funkcji agregujących: `sum`, `min`, `max`, `avg`, `count`, jeśli jako drugi parametr wybrano `function`.<br>
^10^ obsługuje wiele rekordów "Field name,OID prefix,Format" rozdzielonych znakiem nowej linii.

[comment]: # ({/eed27a12-2169bb78})