[comment]: # translation:outdated

[comment]: # ({6bb9f60f-6bb9f60f})
# > Item-object

De volgende objecten zijn direct gerelateerd aan de `item` API.

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

[comment]: # ({5c1db6c5-385ac8b5})
### Item

::: noteclassic
Webitems kunnen niet rechtstreeks worden gemaakt, bijgewerkt of verwijderd via
de Zabbix API.
:::

Het itemobject heeft de volgende eigenschappen.

|Eigenschap|Type|Omschrijving|
|--|--|------|
|itemid|string|*(alleen lezen)* ID van het item.|
|**delay**<br>(vereist)|string|Update-interval van het item. Accepteert seconden of een tijdseenheid met achtervoegsel (30s,1m,2u,1d).<br>Optioneel kunnen één of meer [aangepaste intervallen](/manual/config/items/item/custom_intervals) worden gespecificeerd, zowel als flexibele intervallen als planningsintervallen.<br>Meerdere intervallen worden gescheiden door een puntkomma.<br>Gebruikersmacro's kunnen worden gebruikt. Een enkele macro moet het hele veld vullen. Meerdere macro's in één veld of macro's gemengd met tekst worden niet ondersteund.<br>Flexibele intervallen kunnen worden geschreven als twee macro's gescheiden door een schuine streep (bijv. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Optioneel voor Zabbix trapper, afhankelijke items en voor Zabbix agent (actief) met de sleutel `mqtt.get`.|
|**hostid**<br>(vereist)|string|ID van de host of het sjabloon waartoe het item behoort.<br><br>Voor updatebewerkingen is dit veld *alleen lezen*.|
|**interfaceid**<br>(vereist)|string|ID van de hostinterface van het item.<br><br>Alleen gebruikt voor hostitems. Niet vereist voor Zabbix-agent (actief), Zabbix intern, Zabbix trapper, berekende, afhankelijke, database monitor en scriptitems. Optioneel voor HTTP-agentitems.|
|**key\_**<br>(vereist)|string|Item-sleutel.|
|**name**<br>(vereist)|string|Naam van het item.|
|**type**<br>(vereist)|integer|Type van het item.<br><br>Mogelijke waarden:<br>0 - Zabbix-agent;<br>2 - Zabbix-trapper;<br>3 - Eenvoudige controle;<br>5 - Zabbix intern;<br>7 - Zabbix-agent (actief);<br>9 - Webitem;<br>10 - Externe controle;<br>11 - Database monitor;<br>12 - IPMI-agent;<br>13 - SSH-agent;<br>14 - Telnet-agent;<br>15 - Berekend;<br>16 - JMX-agent;<br>17 - SNMP-trap;<br>18 - Afhankelijk item;<br>19 - HTTP-agent;<br>20 - SNMP-agent;<br>21 - Script|
|**url**<br>(vereist)|string|URL-reeks, alleen vereist voor het itemtype HTTP-agent. Ondersteunt gebruikersmacro's, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.|
|**value\_type**<br>(vereist)|integer|Type van de informatie van het item.<br><br>Mogelijke waarden:<br>0 - numeriek met decimalen;<br>1 - karakter;<br>2 - logboek;<br>3 - numeriek zonder teken;<br>4 - tekst.|
|allow\_traps|integer|Veld voor HTTP-agentitem. Staat toe om de waarde ook op dezelfde manier als bij het type trapperitem in te vullen.<br><br>0 - *(standaard)* Sta niet toe om inkomende gegevens te accepteren.<br>1 - Sta toe om inkomende gegevens te accepteren.|
|authtype|integer|Alleen gebruikt door SSH-agentitems of HTTP-agentitems.<br><br>Mogelijke waarden voor SSH-agentauthenticatiemethode:<br>0 - *(standaard)* wachtwoord;<br>1 - openbare sleutel.<br><br>Mogelijke waarden voor HTTP-agentauthenticatiemethode:<br>0 - *(standaard)* geen<br>1 - basis<br>2 - NTLM<br>3 - Kerberos|
|description|string|Beschrijving van het item.|
|error|string|*(alleen lezen)* Fouttekst als er problemen zijn bij het bijwerken van het item.|
|flags|integer|*(alleen lezen)* Herkomst van het item.<br><br>Mogelijke waarden:<br>0 - een gewoon item;<br>4 - een ontdekt item.|
|follow\_redirects|integer|Veld voor HTTP-agentitem. Volg de omleidingen in de respons bij het ophalen van gegevens.<br><br>0 - Volg geen omleidingen.<br>1 - *(standaard)* Volg omleidingen.|
|headers|object|Veld voor HTTP(S)-verzoekskoppen in een HTTP-agentitem, waarbij de kopnaam als sleutel wordt gebruikt en de kopwaarde als waarde wordt gebruikt.<br><br>Voorbeeld:<br>{ "User-Agent": "Zabbix" }|
|history|string|Een tijdeenheid voor hoe lang de historische gegevens moeten worden bewaard. Accepteert ook gebruikersmacro's.<br><br>Standaard: 90d.|
|http\_proxy|string|Veld voor HTTP(S)-proxyverbinding in een HTTP-agentitem.|
|inventory\_link|integer|ID van het hostinventarisveld dat wordt ingevuld door het item.<br><br>Zie de [hostinventarispagina](/manual/api/reference/host/object#host_inventory) voor een lijst met ondersteunde hostinventarisvelden en hun ID's.<br><br>Standaard: 0.|
|ipmi\_sensor|string|IPMI-sensor. Alleen gebruikt door IPMI-items.|
|jmx\_endpoint|string|Aangepaste verbindingsreeks voor JMX-agent.<br><br>Standaardwaarde:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi|
|lastclock|timestamp|*(alleen lezen)* Tijd waarop het item voor het laatst is bijgewerkt.<br><br>Standaard worden alleen waarden weergegeven die binnen de afgelopen 24 uur vallen. U kunt deze tijdsperiode verlengen door de waarde van de parameter *Maximale weergaveperiode geschiedenis* te wijzigen in het menu *[Beheer → Algemeen](/manual/web_interface/frontend_sections/administration/general#gui)*.|
|lastns|integer|*(alleen lezen)* Nanoseconden waarop het item voor het laatst is bijgewerkt.<br><br>Standaard worden alleen waarden weergegeven die binnen de afgelopen 24 uur vallen. U kunt deze tijdsperiode verlengen door de waarde van de parameter *Maximale weergaveperiode geschiedenis* te wijzigen in het menu *[Beheer → Algemeen](/manual/web_interface/frontend_sections/administration/general#gui)*.|
|lastvalue|string|*(alleen lezen)* Laatste waarde van het item.<br><br>Standaard worden alleen waarden weergegeven die binnen de afgelopen 24 uur vallen. U kunt deze tijdsperiode verlengen door de waarde van de parameter *Maximale weergaveperiode geschiedenis* te wijzigen in het menu *[Beheer → Algemeen](/manual/web_interface/frontend_sections/administration/general#gui)*.|
|logtimefmt|string|Indeling van de tijd in logboekvermeldingen. Alleen gebruikt door logboekitems.|
|master\_itemid|integer|ID van het hoofditem.<br>Recursie tot 3 afhankelijke items en een maximum aantal afhankelijke items van 29999 zijn toegestaan.<br><br>Vereist voor afhankelijke items.|
|output\_format|integer|Veld voor HTTP-agentitem. Moet het antwoord worden geconverteerd naar JSON.<br><br>0 - *(standaard)* Bewaar rauw.<br>1 - Converteer naar JSON.|
|params|string|Aanvullende parameters afhankelijk van het type item:<br>- uitgevoerd script voor SSH- en Telnet-items;<br>- SQL-query voor database monitor items;<br>- formule voor berekende items;<br>- het script voor scriptitem.|
|parameters|array|Aanvullende parameters voor scriptitems. Array van objecten met de eigenschappen 'name' en 'value', waarbij de naam uniek moet zijn.|
|password|string|Wachtwoord voor authenticatie. Gebruikt door eenvoudige controle, SSH, Telnet, database monitor, JMX en HTTP-agentitems.<br>Wanneer gebruikt door JMX, moet ook de gebruikersnaam samen met het wachtwoord worden opgegeven of moeten beide eigenschappen leeg worden gelaten.|
|post\_type|integer|Veld voor HTTP-agentitem. Type post-gegevens die zijn opgeslagen in de eigenschap 'posts'.<br><br>0 - *(standaard)* Ruwe gegevens.<br>2 - JSON-gegevens.<br>3 - XML-gegevens.|
|posts|string|Veld voor HTTP(S)-verzoek-gegevens in een HTTP-agentitem. Gebruikt met post\_type.|
|prevvalue|string|*(alleen lezen)* Vorige waarde van het item.<br><br>Standaard worden alleen waarden weergegeven die binnen de afgelopen 24 uur vallen. U kunt deze tijdsperiode verlengen door de waarde van de parameter *Maximale weergaveperiode geschiedenis* te wijzigen in het menu *[Beheer → Algemeen](/manual/web_interface/frontend_sections/administration/general#gui)*.|
|privatekey|string|Naam van het bestand met de privésleutel.|
|publickey|string|Naam van het bestand met de openbare sleutel.|
|query\_fields|array|Veld voor HTTP-agentitem. Queryparameters. Array van objecten met paren 'key':'value', waarbij de waarde een lege tekenreeks kan zijn.|
|request\_method|integer|Veld voor HTTP-agentitem. Type verzoekmethode.<br><br>0 - *(standaard)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD|
|retrieve\_mode|integer|Veld voor HTTP-agentitem. Welk deel van het antwoord moet worden opgeslagen.<br><br>0 - *(standaard)* Lichaam.<br>1 - Koppen.<br>2 - Zowel lichaam als koppen worden opgeslagen.<br><br>Voor aanvraagmethode HEAD is alleen de waarde 1 toegestaan.|
|snmp\_oid|string|SNMP OID.|
|ssl\_cert\_file|string|Veld voor HTTP-agentitem. Pad naar het openbare SSL-sleutelbestand.|
|ssl\_key\_file|string|Veld voor HTTP-agentitem. Pad naar het privé SSL-sleutelbestand.|
|ssl\_key\_password|string|Veld voor HTTP-agentitem. Wachtwoord voor het SSL-sleutelbestand.|
|state|integer|*(alleen lezen)* Status van het item.<br><br>Mogelijke waarden:<br>0 - *(standaard)* normaal;<br>1 - niet ondersteund.|
|status|integer|Status van het item.<br><br>Mogelijke waarden:<br>0 - *(standaard)* ingeschakeld item;<br>1 - uitgeschakeld item.|
|status\_codes|string|Veld voor HTTP-agentitem. Reeksen vereiste HTTP-statuscodes gescheiden door komma's. Ondersteunt ook gebruikersmacro's als onderdeel van de met komma's gescheiden lijst.<br><br>Voorbeeld: 200,200-{$M},{$M},200-400|
|templateid|string|*(alleen lezen)* ID van het bovenliggende sjabloonitem.<br><br>*Tip*: Gebruik de eigenschap `hostid` om het sjabloon aan te geven waartoe het item behoort.|
|timeout|string|Time-out voor het aanvragen van itemgegevens. Gebruikt voor HTTP-agent- en scriptitems. Ondersteunt gebruikersmacro's.<br><br>standaard: 3s<br>maximale waarde: 60s|
|trapper\_hosts|string|Toegestane hosts. Gebruikt door trapperitems of HTTP-agentitems.|
|trends|string|Een tijdeenheid voor hoe lang de trendgegevens moeten worden bewaard. Accepteert ook gebruikersmacro's.<br><br>Standaard: 365d.|
|units|string|Eenheid van de waarde.|
|username|string|Gebruikersnaam voor authenticatie. Gebruikt door eenvoudige controle, SSH, Telnet, database monitor, JMX en HTTP-agentitems.<br><br>Vereist voor SSH- en Telnet-items.<br>Wanneer gebruikt door JMX, moet ook het wachtwoord worden opgegeven samen met de gebruikersnaam of moeten beide eigenschappen leeg worden gelaten.|
|uuid|string|Universeel uniek identificatienummer, gebruikt voor het koppelen van geïmporteerde items aan reeds bestaande items. Alleen gebruikt voor items op sjablonen. Wordt automatisch gegenereerd als het niet wordt opgegeven.|
|valuemapid|string|ID van de bijbehorende waardeomzetting.|
|verify\_host|integer|Veld voor HTTP-agentitem. Valideer of de hostnaam in de URL zich bevindt in het veld Algemene naam of een veld Alternatieve naam van het hostcertificaat.<br><br>0 - *(standaard)* Niet valideren.<br>1 - Valideren.|
|verify\_peer|integer|Veld voor HTTP-agentitem. Valideer of het hostcertificaat authentiek is.<br><br>0 - *(standaard)* Niet valideren.<br>1 - Valideren.|

Merk op dat voor sommige methoden (update, delete) de vereiste/optie combinatie anders is.

[comment]: # ({/5c1db6c5-385ac8b5})

[comment]: # ({5146f10c-c1b98afa})
### Artikeltag

Het item tag-object heeft de volgende eigenschappen.

|Eigenschap|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|**tag**<br>(verplicht)|string|Naam itemtag.|
|value|string|Waarde itemtag.|

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

[comment]: # ({d697250d-2169bb78})
### Artikel voorbewerking

Het object voorbewerking van het artikel heeft de volgende eigenschappen.

|Property|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|**type**<br>(vereist)|geheel getal|Het type voorbewerkingsoptie.<br><br>Mogelijke waarden:<br>1 - Aangepaste vermenigvuldiger;<br>2 - Rechts bijsnijden;<br>3 - Links bijsnijden;<br>4 - Bijsnijden;<br>5 - Overeenkomen met reguliere expressies;<br>6 - Booleaans naar decimaal;<br>7 - Octaal naar decimaal;<br>8 - Hexadecimaal naar decimaal;<br>9 - Eenvoudige wijziging;<br>10 - Wijziging per seconde;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - Binnen bereik;<br>14 - Komt overeen met reguliere expressie;<br>15 - Komt niet overeen met reguliere expressie;<br>16 - Controleer op fouten in JSON;<br>17 - Controleer op fouten in XML;<br>18 - Controleer op fouten met behulp van reguliere expressie;<br>19 - Verwijder ongewijzigd;<br >20 - Ongewijzigd weggooien met hartslag;<br>21 - JavaScript;<br>22 - Prometheus-patroon;<br>23 - Prometheus naar JSON;<br>24 - CSV naar JSON;<br>25 - Vervang;<br >26 - Controleer niet-ondersteund;<br>27 - XML naar JSON.|
|**params**<br>(verplicht)|string|Aanvullende parameters gebruikt door voorbewerkingsoptie. Meerdere parameters worden gescheiden door een LF-teken (\\n).|
|**error\_handler**<br>(vereist)|integer|Actietype gebruikt in geval van mislukte voorverwerkingsstap.<br><br>Mogelijke waarden:<br>0 - Foutbericht is ingesteld door Zabbix-server;< br>1 - Waarde negeren;<br>2 - Aangepaste waarde instellen;<br>3 - Aangepaste foutmelding instellen.|
|**error\_handler\_params**<br>(vereist)|string|Fouthandlerparameters. Gebruikt met `error_handler`.<br><br>Moet leeg zijn als `error_handler` 0 of 1 is.<br>Kan leeg zijn als `error_handler` 2 is.<br>Kan niet leeg zijn als `error_handler` is 3.|

De volgende parameters en foutafhandelaars worden voor elk ondersteund:
soort voorbewerking.

|Preprocessing type|Naam|Parameter 1|Parameter 2|Parameter 3|Ondersteunde fout-handlers|
|------------------|----|-----------|-----------|- ----------|------------------------|
|1|Aangepaste vermenigvuldiger|getal^1,\ 6^|<|<|0, 1, 2, 3|
|2|Rechts bijsnijden|lijst met tekens^2^|<|<|<|
|3|Links trim|lijst met tekens^2^|<|<|<|
|4|Trim|lijst met tekens^2^|<|<|<|
|5|Reguliere uitdrukking|patroon^3^|output^2^|<|0, 1, 2, 3|
|6|Boolean naar decimaal|<|<|<|0, 1, 2, 3|
|7|Octaal naar decimaal|<|<|<|0, 1, 2, 3|
|8|Hexadecimaal naar decimaal|<|<|<|0, 1, 2, 3|
|9|Eenvoudige wijziging|<|<|<|0, 1, 2, 3|
|10|Verandering per seconde|<|<|<|0, 1, 2, 3|
|11|XML XPath|pad^4^|<|<|0, 1, 2, 3|
|12|JSONPath|pad^4^|<|<|0, 1, 2, 3|
|13|Binnen bereik|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3|
|14|Komt overeen met reguliere expressie|patroon^3^|<|<|0, 1, 2, 3|
|15|Komt niet overeen met reguliere expressie|patroon^3^|<|<|0, 1, 2, 3|
|16|Controleer op fouten in JSON|path^4^|<|<|0, 1, 2, 3|
|17|Controleer op fouten in XML|pad^4^|<|<|0, 1, 2, 3|
|18|Controleer op fouten met reguliere expressie|patroon^3^|output^2^|<|0, 1, 2, 3|
|19|Gooi ongewijzigd weg|<|<|<|<|
|20|Gooi ongewijzigd weg met hartslag|seconden^5,\ 6^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|22|Prometheus-patroon|patroon^6,\ 7^|`value`, `label`, `function`|output^8,\ 9^|0, 1, 2, 3|
|23|Prometheus naar JSON|patroon^6,\ 7^|<|<|0, 1, 2, 3|
|24|CSV naar JSON|karakter^2^|karakter^2^|0,1|0, 1, 2, 3|
|25|Vervangen|zoekreeks^2^|vervanging^2^|<|<|
|26|Aanvinken niet ondersteund|<|<|<|1, 2, 3|
|27|XML naar JSON|<|<|<|0, 1, 2, 3|

^1^ geheel getal of getal met drijvende komma\
^2^ tekenreeks\
^3^ reguliere expressie\
^4^ JSONPath of XML XPath\
^5^ positief geheel getal (met ondersteuning van tijdsuffixen, bijv. 30s, 1m, 2h,
1d)\
^6^ gebruikersmacro\
^7^ Prometheus-patroon volgens de syntaxis:
`<metrische naam>{<labelnaam>="<labelwaarde>", ...} == <waarde>`. Elk
Prometheus-patrooncomponent (metrisch, labelnaam, labelwaarde en metriek
waarde) kan een gebruikersmacro zijn.\
^8^ Prometheus-uitvoer volgens de syntaxis: `<labelnaam>` (kan een gebruikersmacro zijn) als `label` is geselecteerd als de tweede parameter.\
^9^ Een van de aggregatiefuncties: `sum`, `min`, `max`, `avg`, `count` als `function` is geselecteerd als de tweede parameter.

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