[comment]: # aside: 1 [comment]: # ({d1f57367-6bb9f60f}) # Item Objekt Die folgenden Objekte stehen in direktem Zusammenhang mit der `item` API. [comment]: # ({/d1f57367-6bb9f60f}) [comment]: # ({4401882e-385ac8b5}) ### Item ::: noteclassic Web-Items können nicht direkt über die Zabbix API erstellt, aktualisiert oder gelöscht werden. ::: Das Item-Objekt hat die folgenden Eigenschaften. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |itemid|ID|ID des Datenpunkts.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*
- *erforderlich* für Aktualisierungsvorgänge| |delay|string|Aktualisierungsintervall des Datenpunkts.

Akzeptiert Sekunden oder Zeiteinheiten mit Suffix (z. B. 30s, 1m, 2h, 1d) und optional ein oder mehrere [benutzerdefinierte Intervalle](/manual/config/items/item/custom_intervals), alle durch Semikolons getrennt. Benutzerdefinierte Intervalle können eine Mischung aus flexiblen und Zeitplan-Intervallen sein.

Akzeptiert Benutzermakros. Wenn verwendet, muss der Wert ein einzelnes Makro sein. Mehrere Makros oder Makros in Kombination mit Text werden nicht unterstützt. Flexible Intervalle können als zwei durch einen Schrägstrich getrennte Makros geschrieben werden (z. B. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).

Beispiel:
`1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}`

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "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) gesetzt ist oder wenn `type` auf "Zabbix agent (active)" (7) gesetzt ist und `key_` nicht "mqtt.get" enthält| |hostid|ID|ID des Hosts oder der Vorlage, zu der der Datenpunkt gehört.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *konstant*
- *erforderlich* für Erstellungsoperationen| |interfaceid|ID|ID der Host-Schnittstelle des Datenpunkts.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn der Datenpunkt zu einem Host gehört und `type` auf "Zabbix agent", "IPMI agent", "JMX agent", "SNMP trap" oder "SNMP agent" gesetzt ist
- *unterstützt*, wenn der Datenpunkt zu einem Host gehört und `type` auf "Simple check", "External check", "SSH agent", "TELNET agent" oder "HTTP agent" gesetzt ist
- *schreibgeschützt* für erkannte Objekte| |key\_|string|Schlüssel des Datenpunkts.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich* für Erstellungsoperationen
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |name|string|Name des Datenpunkts.
Unterstützt Benutzermakros.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich* für Erstellungsoperationen
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |name\_resolved|string|Name des Datenpunkts mit aufgelösten Benutzermakros.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |type|integer|Typ des Datenpunkts.

Mögliche Werte:
0 - Zabbix agent;
2 - Zabbix trapper;
3 - Simple check;
5 - Zabbix internal;
7 - Zabbix agent (active);
9 - Web item;
10 - External check;
11 - Database monitor;
12 - IPMI agent;
13 - SSH agent;
14 - TELNET agent;
15 - Calculated;
16 - JMX agent;
17 - SNMP trap;
18 - Dependent item;
19 - HTTP agent;
20 - SNMP agent;
21 - Script;
22 - Browser.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich* für Erstellungsoperationen
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |url|string|URL-Zeichenfolge.
Unterstützt Benutzermakros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |value\_type|integer|Informationstyp des Datenpunkts.

Mögliche Werte:
0 - numerisch, Fließkomma;
1 - Zeichen;
2 - Log;
3 - numerisch, vorzeichenlos;
4 - Text;
5 - binär.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich* für Erstellungsoperationen
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |allow\_traps|integer|Erlaubt das Befüllen des Werts ähnlich wie beim Trapper-Datenpunkt.

0 - *(Standard)* Eingehende Daten nicht akzeptieren;
1 - Eingehende Daten akzeptieren.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für erkannte Objekte| |authtype|integer|Authentifizierungsmethode.

Mögliche Werte, wenn `type` auf "SSH agent" gesetzt ist:
0 - *(Standard)* Passwort;
1 - öffentlicher Schlüssel.

Mögliche Werte, wenn `type` auf "HTTP agent" gesetzt ist:
0 - *(Standard)* keine;
1 - basic;
2 - NTLM;
3 - Kerberos;
4 - Digest.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "SSH agent" oder "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte (wenn `type` auf "HTTP agent" gesetzt ist) oder erkannte Objekte| |description|string|Beschreibung des Datenpunkts.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt* für erkannte Objekte| |error|string|Fehlertext, wenn beim Aktualisieren des Datenpunktwerts Probleme auftreten.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |flags|integer|Ursprung des Datenpunkts.

Mögliche Werte:
0 - ein normaler Datenpunkt;
4 - ein erkannter Datenpunkt.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |follow\_redirects|integer|Weiterleitungen der Antwort beim Abrufen der Daten folgen.

Mögliche Werte:
0 - Weiterleitungen nicht folgen;
1 - *(Standard)* Weiterleitungen folgen.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |headers|array|Array von [Headern](#http-header), die beim Ausführen einer HTTP-Anfrage gesendet werden.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |history|string|Zeiteinheit, wie lange die Verlaufsdaten gespeichert werden sollen.
Akzeptiert auch Benutzermakros.

Standard: 31d.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt* für erkannte Objekte| |http\_proxy|string|HTTP(S)-Proxy-Verbindungszeichenfolge.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |inventory\_link|integer|ID des Host-Inventarfelds, das vom Datenpunkt befüllt wird.

Eine Liste der unterstützten Host-Inventarfelder und ihrer IDs finden Sie auf der [Host-Inventarseite](/manual/api/reference/host/object#host-inventory).

Standard: 0.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `value_type` auf "numerisch, Fließkomma", "Zeichen", "numerisch, vorzeichenlos" oder "Text" gesetzt ist
- *schreibgeschützt* für erkannte Objekte| |ipmi\_sensor|string|IPMI-Sensor.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "IPMI agent" gesetzt ist und `key_` nicht auf "ipmi.get" gesetzt ist
- *unterstützt*, wenn `type` auf "IPMI agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |jmx\_endpoint|string|Benutzerdefinierte Verbindungszeichenfolge des JMX agent.

Standardwert: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "JMX agent" gesetzt ist
- *schreibgeschützt* für erkannte Objekte| |lastclock|timestamp|Zeitpunkt, zu dem der Wert des Datenpunkts zuletzt aktualisiert wurde.

Standardmäßig werden nur Werte angezeigt, die in die letzten 24 Stunden fallen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters *Max history display period* im Menübereich *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* ändern.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |lastns|integer|Nanosekunden, zu denen der Wert des Datenpunkts zuletzt aktualisiert wurde.

Standardmäßig werden nur Werte angezeigt, die in die letzten 24 Stunden fallen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters *Max history display period* im Menübereich *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* ändern.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |lastvalue|string|Letzter Wert des Datenpunkts.

Standardmäßig werden nur Werte angezeigt, die in die letzten 24 Stunden fallen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters *Max history display period* im Menübereich *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* ändern.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |logtimefmt|string|Format der Zeit in Logeinträgen.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `value_type` auf "log" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |master\_itemid|ID|ID des Master-Datenpunkts.
Rekursion bis zu 3 abhängige Datenpunkte und eine maximale Anzahl abhängiger Datenpunkte von 29999 sind zulässig.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "Dependent item" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |output\_format|integer|Soll die Antwort in JSON konvertiert werden.

0 - *(Standard)* Rohdaten speichern;
1 - In JSON konvertieren.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |params|string|Zusätzliche Parameter abhängig vom Typ des Datenpunkts:
- ausgeführtes Skript für Datenpunkte vom Typ SSH agent und TELNET agent;
- SQL-Abfrage für Datenpunkte vom Typ Database monitor;
- Formel für berechnete Datenpunkte;
- das Skript für Datenpunkte vom Typ Script und Browser.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "Database monitor", "SSH agent", "TELNET agent", "Calculated", "Script" oder "Browser" gesetzt ist
- *schreibgeschützt* für geerbte Objekte (wenn `type` auf "Script" oder "Browser" gesetzt ist) oder erkannte Objekte| |parameters|object/array|Zusätzliche Parameter, wenn `type` auf "Script" oder "Browser" gesetzt ist. Array von Objekten mit den Eigenschaften `name` und `value`, wobei `name` eindeutig sein muss.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "Script" oder "Browser" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |password|string|Passwort für die Authentifizierung.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "JMX agent" gesetzt ist und `username` gesetzt ist
- *unterstützt*, wenn `type` auf "Simple check", "SSH agent", "TELNET agent", "Database monitor" oder "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte (wenn `type` auf "HTTP agent" gesetzt ist) oder erkannte Objekte| |post\_type|integer|Typ des in der Eigenschaft `posts` gespeicherten Post-Dateninhalts.

Mögliche Werte:
0 - *(Standard)* Rohdaten;
2 - JSON-Daten;
3 - XML-Daten.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |posts|string|HTTP(S)-Anfragedaten des Nachrichtentexts.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "HTTP agent" gesetzt ist und `post_type` auf "JSON data" oder "XML data" gesetzt ist
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist und `post_type` auf "Raw data" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |prevvalue|string|Vorheriger Wert des Datenpunkts.

Standardmäßig werden nur Werte angezeigt, die in die letzten 24 Stunden fallen. Sie können diesen Zeitraum verlängern, indem Sie den Wert des Parameters *Max history display period* im Menübereich *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* ändern.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |privatekey|string|Name der Datei des privaten Schlüssels.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "SSH agent" gesetzt ist und `authtype` auf "public key" gesetzt ist
- *schreibgeschützt* für erkannte Objekte| |publickey|string|Name der Datei des öffentlichen Schlüssels.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "SSH agent" gesetzt ist und `authtype` auf "public key" gesetzt ist
- *schreibgeschützt* für erkannte Objekte| |query\_fields|array|Array von [Abfragefeldern](#http-query-field), die beim Ausführen einer HTTP-Anfrage gesendet werden.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |request\_method|integer|Typ der Anfragemethode.

Mögliche Werte:
0 - *(Standard)* GET;
1 - POST;
2 - PUT;
3 - HEAD.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |retrieve\_mode|integer|Welcher Teil der Antwort gespeichert werden soll.

Mögliche Werte, wenn `request_method` auf "GET", "POST" oder "PUT" gesetzt ist:
0 - *(Standard)* Body;
1 - Header;
2 - Sowohl Body als auch Header werden gespeichert.

Mögliche Werte, wenn `request_method` auf "HEAD" gesetzt ist:
1 - Header.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |snmp\_oid|string|SNMP-OID.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "SNMP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |ssl\_cert\_file|string|Pfad zur öffentlichen SSL-Schlüsseldatei.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |ssl\_key\_file|string|Pfad zur privaten SSL-Schlüsseldatei.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |ssl\_key\_password|string|Passwort für die SSL-Schlüsseldatei.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |state|integer|Status des Datenpunkts.

Mögliche Werte:
0 - *(Standard)* normal;
1 - nicht unterstützt.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |status|integer|Status des Datenpunkts.

Mögliche Werte:
0 - *(Standard)* aktivierter Datenpunkt;
1 - deaktivierter Datenpunkt.| |status\_codes|string|Durch Kommas getrennte Bereiche erforderlicher HTTP-Statuscodes.
Unterstützt auch Benutzermakros als Teil einer durch Kommas getrennten Liste.

Beispiel: 200,200-{$M},{$M},200-400

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |templateid|ID|ID des übergeordneten Vorlagen-Datenpunkts.

*Hinweis*: Verwenden Sie die Eigenschaft `hostid`, um die Vorlage anzugeben, zu der der Datenpunkt gehört.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |timeout|string|Zeitüberschreitung für die Abfrage des Datenpunkts.
Akzeptiert Sekunden oder Zeiteinheiten mit Suffix (z. B. 30s, 1m). Akzeptiert auch Benutzermakros.

Möglicher Wertebereich: 1-600s.

Standard: "" - Proxy-/Globaleinstellungen verwenden.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "Zabbix agent" (0), "Simple check" (3) und `key_` nicht mit "`vmware.`" und "`icmpping`" beginnt, "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) und `snmp_oid` mit "`walk[`" oder "`get[`" beginnt, "Script" (21), "Browser" (22) gesetzt ist
- *schreibgeschützt* für geerbte und erkannte Objekte| |trapper\_hosts|string|Zulässige Hosts.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt* für erkannte Objekte
- *unterstützt*, wenn `type` auf "Zabbix trapper" gesetzt ist oder wenn `type` auf "HTTP agent" gesetzt ist und `allow_traps` auf "Eingehende Daten akzeptieren" gesetzt ist| |trends|string|Zeiteinheit, wie lange die Trenddaten gespeichert werden sollen.
Akzeptiert auch Benutzermakros.

Standard: 365d.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `value_type` auf "numerisch, Fließkomma" oder "numerisch, vorzeichenlos" gesetzt ist
- *schreibgeschützt* für erkannte Objekte| |units|string|Werteinheiten.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `value_type` auf "numerisch, Fließkomma" oder "numerisch, vorzeichenlos" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |username|string|Benutzername für die Authentifizierung.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *erforderlich*, wenn `type` auf "SSH agent", "TELNET agent" gesetzt ist oder wenn `type` auf "JMX agent" gesetzt ist und `password` gesetzt ist
- *unterstützt*, wenn `type` auf "Simple check", "Database monitor" oder "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte (wenn `type` auf "HTTP agent" gesetzt ist) oder erkannte Objekte| |uuid|string|Universell eindeutige Kennung, verwendet, um importierte Datenpunkte mit bereits vorhandenen zu verknüpfen. Wird automatisch generiert, wenn nicht angegeben.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn der Datenpunkt zu einer Vorlage gehört| |valuemapid|ID|ID der zugeordneten Wertzuordnung.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `value_type` auf "numerisch, Fließkomma", "Zeichen" oder "numerisch, vorzeichenlos" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |verify\_host|integer|Ob der Hostname der Verbindung mit dem im Zertifikat des Hosts übereinstimmt, validiert werden soll.

Mögliche Werte:
0 - *(Standard)* nicht validieren;
1 - validieren.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| |verify\_peer|integer|Ob das Zertifikat des Hosts als authentisch validiert werden soll.

Mögliche Werte:
0 - *(Standard)* nicht validieren;
1 - validieren.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `type` auf "HTTP agent" gesetzt ist
- *schreibgeschützt* für geerbte Objekte oder erkannte Objekte| [comment]: # ({/4401882e-385ac8b5}) [comment]: # ({ab5307fa-7efc456e}) #### HTTP-Header Das Header-Objekt hat die folgenden Eigenschaften: |Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung| |--------|---------------------------------------------------|-----------| |name|string|Name des HTTP-Headers.

[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *erforderlich*| |value|string|Wert des Headers.

[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *erforderlich*| [comment]: # ({/ab5307fa-7efc456e}) [comment]: # ({5b4177f3-ee8852f1}) #### HTTP-Abfragefeld Das Abfragefeldobjekt definiert einen Namen und einen Wert, die zur Angabe eines URL-Parameters verwendet werden. Es hat die folgenden Eigenschaften: |Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung| |--------|---------------------------------------------------|-----------| |name|string|Name des Parameters.

[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *erforderlich*| |value|string|Parameterwert.

[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *erforderlich*| [comment]: # ({/5b4177f3-ee8852f1}) [comment]: # ({c9a1b21e-c1b98afa}) ### Datenpunkt-Tag Das Objekt "Datenpunkt-Tag" hat die folgenden Eigenschaften. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Name des Datenpunkt-Tags.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |value|string|Wert des Datenpunkt-Tags.| [comment]: # ({/c9a1b21e-c1b98afa}) [comment]: # ({eed27a12-2169bb78}) ### Item-Vorverarbeitung Das Objekt der Item-Vorverarbeitung hat die folgenden Eigenschaften. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |type|integer|Der Typ der Vorverarbeitungsoption.

Mögliche Werte:
1 - Benutzerdefinierter Multiplikator;
2 - Rechts abschneiden;
3 - Links abschneiden;
4 - Abschneiden;
5 - Regulärer Ausdruck;
6 - Boolesch zu Dezimal;
7 - Oktal zu Dezimal;
8 - Hexadezimal zu Dezimal;
9 - Einfache Änderung;
10 - Änderung pro Sekunde;
11 - XML XPath;
12 - JSONPath;
13 - Im Bereich;
14 - Entspricht regulärem Ausdruck;
15 - Entspricht nicht regulärem Ausdruck;
16 - Auf Fehler in JSON prüfen;
17 - Auf Fehler in XML prüfen;
18 - Auf Fehler mithilfe regulären Ausdrucks prüfen;
19 - Unverändert verwerfen;
20 - Unverändert verwerfen mit Heartbeat;
21 - JavaScript;
22 - Prometheus-Muster;
23 - Prometheus zu JSON;
24 - CSV zu JSON;
25 - Ersetzen;
26 - Nicht unterstützt prüfen;
27 - XML zu JSON;
28 - SNMP-Walk-Wert;
29 - SNMP-Walk zu JSON;
30 - SNMP-Get-Wert.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*| |params|string|Zusätzliche Parameter, die von der Vorverarbeitungsoption verwendet werden.
Mehrere Parameter werden durch das Zeilenumbruchzeichen (\\n) getrennt.

Wenn `type` auf "Nicht unterstützt prüfen" gesetzt ist, folgen die Parameter der Syntax `[\n]`, wobei *pattern* ein regulärer Ausdruck und *scope* einer der folgenden Werte ist:
-1 - beliebigen Fehler abgleichen;
\ 0 - prüfen, ob die Fehlermeldung mit *pattern* übereinstimmt;
\ 1 - prüfen, ob die Fehlermeldung nicht mit *pattern* übereinstimmt.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* wenn `type` auf "Benutzerdefinierter Multiplikator" (1), "Rechts abschneiden" (2), "Links abschneiden" (3), "Abschneiden" (4), "Regulärer Ausdruck" (5), "XML XPath" (11), "JSONPath" (12), "Im Bereich" (13), "Entspricht regulärem Ausdruck" (14), "Entspricht nicht regulärem Ausdruck" (15), "Auf Fehler in JSON prüfen" (16), "Auf Fehler in XML prüfen" (17), "Auf Fehler mithilfe regulären Ausdrucks prüfen" (18), "Unverändert verwerfen mit Heartbeat" (20), "JavaScript" (21), "Prometheus-Muster" (22), "Prometheus zu JSON" (23), "CSV zu JSON" (24), "Ersetzen" (25), "Nicht unterstützt prüfen" (26), "SNMP-Walk-Wert" (28), "SNMP-Walk zu JSON" (29) oder "SNMP-Get-Wert" (30) gesetzt ist| |error\_handler|integer|Aktionstyp, der im Falle eines Fehlers bei einem Vorverarbeitungsschritt verwendet wird.

Mögliche Werte:
0 - Die Fehlermeldung wird vom Zabbix-Server gesetzt;
1 - Wert verwerfen;
2 - Benutzerdefinierten Wert setzen;
3 - Benutzerdefinierte Fehlermeldung setzen.

Mögliche Werte, wenn `type` auf "Nicht unterstützt prüfen" gesetzt ist:
1 - Wert verwerfen;
2 - Benutzerdefinierten Wert setzen;
3 - Benutzerdefinierte Fehlermeldung setzen.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* wenn `type` auf "Benutzerdefinierter Multiplikator" (1), "Regulärer Ausdruck" (5), "Boolesch zu Dezimal" (6), "Oktal zu Dezimal" (7), "Hexadezimal zu Dezimal" (8), "Einfache Änderung" (9), "Änderung pro Sekunde" (10), "XML XPath" (11), "JSONPath" (12), "Im Bereich" (13), "Entspricht regulärem Ausdruck" (14), "Entspricht nicht regulärem Ausdruck" (15), "Auf Fehler in JSON prüfen" (16), "Auf Fehler in XML prüfen" (17), "Auf Fehler mithilfe regulären Ausdrucks prüfen" (18), "Prometheus-Muster" (22), "Prometheus zu JSON" (23), "CSV zu JSON" (24), "Nicht unterstützt prüfen" (26), "XML zu JSON" (27), "SNMP-Walk-Wert" (28), "SNMP-Walk zu JSON" (29) oder "SNMP-Get-Wert" (30) gesetzt ist| |error\_handler\_params|string|Parameter des Fehlerbehandlers.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* wenn `error_handler` auf "Benutzerdefinierten Wert setzen" oder "Benutzerdefinierte Fehlermeldung setzen" gesetzt ist| Die folgenden Parameter und Fehlerbehandler werden für jeden Vorverarbeitungstyp unterstützt. |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |1|Benutzerdefinierter Multiplikator|number^1, 6^|<|<|0, 1, 2, 3| |2|Rechts abschneiden|Liste von Zeichen^2^|<|<|<| |3|Links abschneiden|Liste von Zeichen^2^|<|<|<| |4|Abschneiden|Liste von Zeichen^2^|<|<|<| |5|Regulärer Ausdruck|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolesch zu Dezimal|<|<|<|0, 1, 2, 3| |7|Oktal zu Dezimal|<|<|<|0, 1, 2, 3| |8|Hexadezimal zu Dezimal|<|<|<|0, 1, 2, 3| |9|Einfache Änderung|<|<|<|0, 1, 2, 3| |10|Änderung pro Sekunde|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|Im Bereich|min^1, 6^|max^1, 6^|<|0, 1, 2, 3| |14|Entspricht regulärem Ausdruck|pattern^3^|<|<|0, 1, 2, 3| |15|Entspricht nicht regulärem Ausdruck|pattern^3^|<|<|0, 1, 2, 3| |16|Auf Fehler in JSON prüfen|path^4^|<|<|0, 1, 2, 3| |17|Auf Fehler in XML prüfen|path^4^|<|<|0, 1, 2, 3| |18|Auf Fehler mithilfe regulären Ausdrucks prüfen|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Unverändert verwerfen|<|<|<|<| |20|Unverändert verwerfen mit Heartbeat|seconds^5, 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus-Muster|pattern^6, 7^|`value`, `label`, `function`|output^8, 9^|0, 1, 2, 3| |23|Prometheus zu JSON|pattern^6, 7^|<|<|0, 1, 2, 3| |24|CSV zu JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Ersetzen|search string^2^|replacement^2^|<|<| |26|Nicht unterstützt prüfen|scope^1^|pattern^3, 6^|<|1, 2, 3| |27|XML zu JSON|<|<|<|0, 1, 2, 3| |28|SNMP-Walk-Wert|OID^2^|Format:
0 - Unverändert
1 - UTF-8 aus Hex-STRING
2 - MAC aus Hex-STRING
3 - Integer aus BITS|<|0, 1, 2, 3| |29|SNMP-Walk zu JSON^10^|Field name^2^|OID prefix^2^|Format:
0 - Unverändert
1 - UTF-8 aus Hex-STRING
2 - MAC aus Hex-STRING
3 - Integer aus BITS|0, 1, 2, 3| |30|SNMP-Get-Wert|Format:
1 - UTF-8 aus Hex-STRING
2 - MAC aus Hex-STRING
3 - Integer aus BITS|<|<|0, 1, 2, 3| ^1^ Gleitkommazahl (Ganzzahlen werden implizit in Float-Werte umgewandelt)
^2^ Zeichenfolge
^3^ regulärer Ausdruck
^4^ JSONPath oder XML XPath
^5^ positive Ganzzahl (mit Unterstützung von Zeitsuffixen, z. B. 30s, 1m, 2h, 1d)
^6^ Benutzermakro
^7^ Prometheus-Muster nach der Syntax: `{