[comment]: # translation:outdated [comment]: # ({58fbd3bc-58fbd3bc}) # item.get [comment]: # ({/58fbd3bc-58fbd3bc}) [comment]: # ({14484745-673edf7f}) ### Beschrijving `integer/array item.get(object parameters)` Deze methode maakt het mogelijk om items op te halen op basis van de opgegeven parameters. ::: noteclassic Deze methode is beschikbaar voor gebruikers van elk type. Toestemming om de methode te gebruiken kan worden ingetrokken in de instellingen van de gebruikersrol. Zie [Gebruikersrollen](/manual/web_interface/frontend_sections/users/user_roles) voor meer informatie. ::: [comment]: # ({/14484745-673edf7f}) [comment]: # ({acfa3c68-cc946363}) ### Parameters `(object)` Parameters die de gewenste uitvoer definiëren. De methode ondersteunt de volgende parameters. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Omschrijving| |--|--|------| |itemids|string/array|Geef alleen items terug met de opgegeven ID's.| |groupids|string/array|Geef alleen items terug die behoren tot de hosts van de opgegeven groepen.| |templateids|string/array|Geef alleen items terug die behoren tot de opgegeven templates.| |hostids|string/array|Geef alleen items terug die behoren tot de opgegeven hosts.| |proxyids|string/array|Geef alleen items terug die worden gemonitord door de opgegeven proxies.| |interfaceids|string/array|Geef alleen items terug die de opgegeven hostinterfaces gebruiken.| |graphids|string/array|Geef alleen items terug die worden gebruikt in de opgegeven grafieken.| |triggerids|string/array|Geef alleen items terug die worden gebruikt in de opgegeven triggers.| |webitems|flag|Neem webitems op in het resultaat.| |inherited|boolean|Indien ingesteld op `true`, geef alleen items terug die geërfd zijn van een template.| |templated|boolean|Indien ingesteld op `true`, geef alleen items terug die behoren tot templates.| |monitored|boolean|Indien ingesteld op `true`, geef alleen ingeschakelde items terug die behoren tot gemonitorde hosts.| |group|string|Geef alleen items terug die behoren tot een groep met de opgegeven naam.| |host|string|Geef alleen items terug die behoren tot een host met de opgegeven naam.| |evaltype|integer|Regels voor tag-zoeken.

Mogelijke waarden:
0 - (standaard) And/Or;
2 - Of.| |tags|array van objecten|Geef alleen items terug met de opgegeven tags. Exacte overeenkomst op tag en hoofdlettergevoelige of hoofdletterongevoelige zoekopdracht op tagwaarde, afhankelijk van de operatorwaarde.
Formaat: `[{"tag": "", "value": "", "operator": ""}, ...]`.
Een lege array geeft alle items terug.

Mogelijke operator types:
0 - (standaard) Like;
1 - Gelijk aan;
2 - Niet als;
3 - Niet gelijk aan;
4 - Bestaat;
5 - Bestaat niet.| |with\_triggers|boolean|Indien ingesteld op `true`, geef alleen items terug die worden gebruikt in triggers.| |selectHosts|query|Geef een [`hosts`](/manual/api/reference/host/object) eigenschap terug met een array van hosts waartoe het item behoort.| |selectInterfaces|query|Geef een [`interfaces`](/manual/api/reference/hostinterface/object) eigenschap terug met een array van hostinterfaces die door het item worden gebruikt.| |selectTriggers|query|Geef een [`triggers`](/manual/api/reference/trigger/object) eigenschap terug met de triggers waarin het item wordt gebruikt.

Ondersteunt `count`.| |selectGraphs|query|Geef een [`graphs`](/manual/api/reference/graph/object) eigenschap terug met de grafieken die het item bevatten.

Ondersteunt `count`.| |selectDiscoveryRule|query|Geef een [`discoveryRule`](/manual/api/reference/drule/object) eigenschap terug met de LLD-regel die het item heeft gemaakt.| |selectItemDiscovery|query|Geef een `itemDiscovery` eigenschap terug met het item ontdekkingsobject. Het item ontdekkingsobject koppelt het item aan een itemprototype waaruit het is gemaakt.

Heeft de volgende eigenschappen:
`itemdiscoveryid` - `(string)` ID van de item ontdekking;
`itemid` - `(string)` ID van het ontdekte item;
`parent_itemid` - `(string)` ID van het itemprototype waaruit het item is gemaakt;
`key_` - `(string)` sleutel van het itemprototype;
`lastcheck` - `(timestamp)` tijd waarop het item voor het laatst is ontdekt;
`ts_delete` - `(timestamp)` tijd waarop een item dat niet langer wordt ontdekt, zal worden verwijderd.| |selectPreprocessing|query|Geef een [`preprocessing`](/manual/api/reference/item/object#item_preprocessing) eigenschap terug met item voorverwerkingsopties.

Heeft de volgende eigenschappen:
`type` - `(string)` Het type voorverwerkingsoptie:
1 - Aangepaste vermenigvuldiger;
2 - Rechts trimmen;
3 - Links trimmen;
4 - Trimmen;
5 - Overeenkomst met reguliere expressie;
6 - Booleaan naar decimaal;
7 - Octaal naar decimaal;
8 - Hexadecimaal naar decimaal;
9 - Eenvoudige verandering;
10 - Verandering per seconde;
11 - XML XPath;
12 - JSONPath;
13 - In bereik;
14 - Overeenkomst met reguliere expressie;
15 - Niet overeenkomend met reguliere expressie;
16 - Controleren op fout in JSON;
17 - Controleren op fout in XML;
18 - Controleren op fout met reguliere expressie;
19 - Onveranderd negeren;
20 - Onveranderd negeren met heartbeat;
21 - JavaScript;
22 - Prometheus patroon;
23 - Prometheus naar JSON;
24 - CSV naar JSON;
25 - Vervangen;
26 - Controleren op niet-ondersteunde waarde;
27 - XML naar JSON;
28 - SNMP loopwaarde;
29 - SNMP loop naar JSON.
`params` - `(string)` Aanvullende parameters gebruikt door voorverwerkingsoptie. Meerdere parameters worden gescheiden door het nieuwe regelteken (\\n).
`error_handler` - `(string)` Actietype dat wordt gebruikt bij fout in voorverwerkingsstap:
0 - Foutmelding wordt ingesteld door Zabbix server;
1 - Waarde negeren;
2 - Aangepaste waarde instellen;
3 - Aangepaste foutmelding instellen.
`error_handler_params` - `(string)` Parameters voor foutafhandelaar.| |selectTags|query|Geef de item tags terug in de [`tags`](/manual/api/reference/item/object#Item_tag) eigenschap.| |selectValueMap|query|Geef een [`valuemap`](/manual/api/reference/valuemap/object) eigenschap terug met item waardekaart.| |filter|object|Geef alleen resultaten terug die exact overeenkomen met de opgegeven filter.
`host` - technische naam van de host waartoe het item behoort.| |limitSelects|integer|Beperkt het aantal records dat wordt geretourneerd door subselects.
`selectGraphs` - resultaten worden gesorteerd op `name`;
`selectTriggers` - resultaten worden gesorteerd op `description`.| |sortfield|string/array|Sorteer het resultaat op de opgegeven eigenschappen.
\r\n]]>\r\n", "status_codes": "200", "follow_redirects": "0", "post_type": "3", "http_proxy": "", "headers": [], "retrieve_mode": "1", "request_method": "3", "output_format": "0", "ssl_cert_file": "", "ssl_key_file": "", "ssl_key_password": "", "verify_peer": "0", "verify_host": "0", "allow_traps": "0", "uuid": "", "state": "0", "error": "", "parameters": [], "lastclock": "0", "lastns": "0", "lastvalue": "", "prevvalue": "" } ], "id": 1 } ``` [comment]: # ({/37edd810-94dc4b21}) [comment]: # ({6697de6d-f4b01bbe}) #### Items ophalen met voorbewerkingsregels Haal alle items op en hun voorbewerkingsregels op voor een specifiek host-ID. [Aanvraag](/handleiding/api#uitvoeren-van-aanvragen): ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": ["itemid", "name", "key_"], "selectPreprocessing": "extend", "hostids": "10254" }, "id": 1 } ``` Antwoord: ```json { "jsonrpc": "2.0", "result": { "itemid": "23865", "name": "HTTP-agentvoorbeeld JSON", "key_": "json", "preprocessing": [ { "type": "12", "params": "$.random", "error_handler": "1", "error_handler_params": "" } ] }, "id": 1 } ``` [comment]: # ({/6697de6d-f4b01bbe}) [comment]: # ({febb018b-d3276b35}) ### Zie ook - [Ontdekkingsregel](/manual/api/reference/discoveryrule/object#discovery_rule) - [Grafiek](/manual/api/reference/graph/object#graph) - [Host](/manual/api/reference/host/object#host) - [Host-interface](/manual/api/reference/hostinterface/object#host_interface) - [Trigger](/manual/api/referentie/trigger/object#trigger) [comment]: # ({/febb018b-d3276b35}) [comment]: # ({a6ef1d0f-a6ef1d0f}) ### Bron CItem::get() in *ui/include/classes/api/services/CItem.php*. [comment]: # ({/a6ef1d0f-a6ef1d0f})