[comment]: # aside: 1 [comment]: # ({d1f57367-6bb9f60f}) # Item Objekt Die folgenden Objekte stehen in direktem Zusammenhang mit der `item` API. [comment]: # ({/d1f57367-6bb9f60f}) [comment]: # ({68ea2686-385ac8b5}) ### Item ::: noteclassic Web items können nicht direkt über die Zabbix API erstellt, aktualisiert oder gelöscht werden. ::: Das Objekt "item" 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 Aktualisierungsoperationen| |delay|string|Aktualisierungsintervall des Datenpunkts.

Akzeptiert Sekunden oder Zeiteinheiten mit Suffix (z. B. 30s, 1m, 2h, 1d) und optional einen 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) oder "Browser" (22) gesetzt ist, oder wenn `type` auf "Zabbix agent (active)" (7) gesetzt ist und `key_` kein "mqtt.get" enthält| |hostid|ID|ID des Hosts oder der Vorlage, zu dem 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}, {HOST.PORT}, {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 float;
1 - Zeichen;
2 - Log;
3 - numerisch unsigned;
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 Probleme beim Aktualisieren des Datenpunktwerts auftreten.

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

Mögliche Werte:
0 - ein normaler Datenpunkt;
4 - ein aus einem Prototyp konvertierter Datenpunkt.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |follow\_redirects|integer|Antwort-Weiterleitungen beim Abrufen von 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 float", "Zeichen", "numerisch unsigned" 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 innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Parameter *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 innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Parameter *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 innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Parameter *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.

[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 HTTP-Post-Body.

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|Daten des HTTP(S)-Anfragebodys.

[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 innerhalb der letzten 24 Stunden liegen. Sie können diesen Zeitraum verlängern, indem Sie den Parameter *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 der erforderlichen HTTP-Statuscodes.
Unterstützt auch Benutzermakros als Teil der 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|Timeout 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 float" oder "numerisch unsigned" gesetzt ist
- *schreibgeschützt* für erkannte Objekte| |units|string|Einheiten des Werts.

[Property behavior](/manual/api/reference_commentary#property-behavior):
- *unterstützt* wenn `value_type` auf "numerisch float" oder "numerisch unsigned" 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, die verwendet wird, um den importierten Datenpunkt 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 zugehörigen Wertzuordnung.

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

Mögliche Werte:
0 - *(Standard)* nicht prüfen;
1 - prüfen.

[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 geprüft werden soll, dass das Zertifikat des Hosts authentisch ist.

Mögliche Werte:
0 - *(Standard)* nicht prüfen;
1 - prüfen.

[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]: # ({/68ea2686-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 Datenpunkt-Tag-Objekt 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 trimmen;
3 - Links trimmen;
4 - Trimmen;
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 mit Heartbeat verwerfen;
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 ist 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 trimmen" (2), "Links trimmen" (3), "Trimmen" (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 mit Heartbeat verwerfen" (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 - 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 trimmen|list of characters^2^|<|<|<| |3|Links trimmen|list of characters^2^|<|<|<| |4|Trimmen|list of characters^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 mit Heartbeat verwerfen|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 Gleitkommawerte umgewandelt)
^2^ Zeichenkette
^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: `{