[comment]: # ({58fbd3bc-58fbd3bc})
# item.get

[comment]: # ({/58fbd3bc-58fbd3bc})

[comment]: # ({14484745-673edf7f})
### Descripció

`integer/array item.get(object parameters)`

El mètode permet recuperar elements segons els paràmetres proveïts.

::: noteclassic
Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/14484745-673edf7f})

[comment]: # ({d8124a5c-cc946363})
### Paràmetres

`(object)` Paràmetres que defineixen la sortida esperada.

El mètode admet els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|itemids|string/array|Retorna només els elements amb els identificadors donats.|
|groupids|string/array|Retorna només els elements que pertanyen als equips dels grups donats.|
|templateids|string/array|Retorna només els elements que pertanyen a les plantilles donades.|
|hostids|string/array|Retorna només els elements que pertanyen als equips donats.|
|proxyids|string/array|Retorna només els elements monitorats pels proxys donats.|
|interfaceids|string/array|Retorna només elements que empren les interfícies d'equip donades.|
|graphids|string/array|Retorna només els elements emprats en els gràfics donats.|
|triggerids|string/array|Retorna només els elements emprats en els triggers donats.|
|webitems|flag|Inclou elements web al resultat.|
|inherited|boolean|Si s'estableix a `true`, només retorna els elements heretats d'un model.|
|templated|boolean|Si s'estableix a `true`, retorna només els elements que pertanyen a les plantilles.|
|monitored|boolean|Si s'estableix a `true`, només retorna els elements activats que pertanyen als equips monitorats.|
|group|string|Retorna només els elements que pertanyen a un grup amb el nom especificat.|
|host|string|Retorna només els elements que pertanyen a un equip amb el nom especificat.|
|evaltype|integer|Regles de cerca d'etiquetes.<br><br>Valors possibles:<br>0 - (per defecte) I/O;<br>2 - O.|
|tags|array of objects|Retorna només els elements amb les etiquetes donades. Concordança exacta per lectura de btag i cerca que distingeix entre majúscules i minúscules o no distingeix entre majúscules i minúscules pel valor de l'etiqueta en funció del valor de l'operador.<br>Format: `[{"tag": "<etiqueta>", "valor": " <valor>", " operador": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els elements.<br><br>Tipus d'operadors possibles:<br>0 - (per defecte) És com;<br> 1 - Igual;<br>2 - No és com;<br>3 - No és igual<br>4 - Existeix;<br>5 - No existeix.|
|with\_triggers|boolean|Si s'estableix a `true`, només retorna els elements emprats als triggers.|
|selectHosts|query|Retorna una propietat [equips](/manual/api/reference/host/object) que conté una matriu d'equips a què pertany l'element.|
|selectInterfaces|query|Retorna una propietat [interfícies](/manual/api/reference/hostinterface/object) que conté una matriu d'interfícies d'equip emprades per l'element.|
|selectTriggers|query|Retorna una propietat [triggers](/manual/api/reference/trigger/object) que conté els triggers que empra aquest element.<br><br>Admet `count`.|
|selectGraphs|query|Retorna una propietat [gràfics](/manual/api/reference/graph/object) que conté els gràfics que empra l'element.<br><br>Admet `count`.|
|selectDiscoveryRule|query|Retorna una propietat [regla de descoberta](/manual/api/reference/discoveryrule/object) que conté la regla de descoberta de baix nivell que va crear l'element.|
|selectItemDiscovery|query|Retorna l'objecte de descoberta d'elements a la propietat `itemDiscovery`. L'objecte de descoberta d'elements enllaça l'element a un prototip d'element des del qual s'ha creat.<br><br>Té les propietats següents:<br>`itemdiscoveryid` - `(cadena)` Identificador de descoberta de l'element;<br>`itemid ` - `(cadena)` Identificació de l'element descobert ;<br>`parent_itemid` - `(cadena)` Identificador del prototip d'element des del qual s'ha creat l'element;<br>`key_` - `(cadena)` clau del prototip de l'element;< br>`lastcheck` - `(timestamp)` quan l'element es va descobrir per última vegada;< br>`ts_delete` - `(timestamp)` quan s'esborrarà un element que ja no es descobreix.|
|selectPreprocessing|query|Retorna una propietat [preprocessament](/manual/api/reference/item/object#item_preprocessing) que conté opcions de preprocessament d'elements.<br><br>Té les propietats següents:<br>`type ` - ` (cadena)` Tipus d'opcions de preprocessament:<br>1 - Multiplicador personalitzat;<br>2 - Eliminació d'espais en blanc al final;<br>3 - Eliminació d'espais en blanc al final;<br>4 - Eliminació dels espais inicials i finals;<br>5 - Expressió regular;<br>6 - Booleà a decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br> 9 - Canvi únic;<br>10 - Canvi per segon;<br >11 - XML ​​​​XPath;<br>12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular ;<br>15 - No coincideix amb l'expressió regular ;<br>16 - Troba l'error en JSON ;<br>17 - Trobar l'error en XML ;<br>18 - Trobar l'error amb una expressió regular;<br>19 - Suprimir sense modificacions;<br> 20 - Suprimeix sense modificacions amb batec;<br>21 - JavaScript;<br>22 - Patró de Prometheus;<br>23 - Prometeu a JSON;<br>24 - CSV a JSON; <br>25 - Substituïu ;<br>26 - Comproveu si hi ha valors no compatibles ​​;<br>27 - XML ​​​​a JSON.<br><br>`params` - `(string)` Paràmetres addicionals emprats per l'opció de preprocessament. Diversos paràmetres són separats per un caràcter LF (\\n).<br>`error_handler` - `(cadena)` Tipus d'acció que s'empra en l'error del pas de preprocessament:<br>0 - El servidor Zabbix defineix el missatge d'error; <br>1 - Elimina el valor;<br>2 - Estableix un valor personalitzat;<br>3 - Estableix un missatge d'error personalitzat. <br><br>`error_handler_params` - `(cadena)` Paràmetres del gestor d'errors.|
|selectTags|query|Retorna etiquetes d'element a la propietat [etiquetes](/manual/api/reference/item/object#Item_tag).|
|selectValueMap|query|Retorna una propietat [mapa de valors](/manual/api/reference/valuemap/object) que conté el mapa de valors de l'element.|
|filter|object|Només retorna resultats que coincideixen exactament amb el filtre donat.<br><br>Accepta una matriu on les claus són noms de propietat i els valors són un valor únic o una matriu de valors per comparar.< br><br>Admet filtres addicionals:<br>`host` - Nom tècnic de l'equip al qual pertany l'element.|
|limitSelects|integer|Limita el nombre de registres retornats per les subconsultes.<br><br>S'aplica a les subconsultes següents:<br>`selectGraphs`: els resultats s'ordenaran per `nom`;< br>`selectTriggers`: resultats s'ordenarà per `descripció`.|
|sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `itemid`, `name`, `key_`, `delay`, `history`, `trends` , `tipus` i `estat`.|
|countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).|
|editable|boolean|^|
|excludeSearch|boolean|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/d8124a5c-cc946363})

[comment]: # ({7223bab1-7223bab1})
### Valors de retorn

`(integer/array)` Retorna un d'entre:

-   una taula d'objectes;
-   el recompte d'objectes recuperats, si s'empra el paràmetre `countOutput`.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Exemples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({6e846eda-59b84d93})
#### Cercar elements per una clau

Recupera tots els elements emprats amb l'ID d'equip específics que contenen el mot "system.cpu" a la clau d'element, i ordenar els resultats per nom.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "item.get",
    "params": {
        "output": "extend",
        "hostids": "10084",
        "with_triggers": true,
        "search": {
            "key_": "system.cpu"
        },
        "sortfield": "name"
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "42269",
            "type": "18",
            "snmp_oid": "",
            "hostid": "10084",
            "name": "CPU utilization",
            "key_": "system.cpu.util",
            "delay": "0",
            "history": "7d",
            "trends": "365d",
            "status": "0",
            "value_type": "0",
            "trapper_hosts": "",
            "units": "%",
            "logtimefmt": "",
            "templateid": "42267",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "0",
            "interfaceid": "0",
            "description": "CPU utilization in %.",
            "inventory_link": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "42264",
            "timeout": "3s",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "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": "0",
            "prevvalue": "0"
        },
        {
            "itemid": "42259",
            "type": "0",
            "snmp_oid": "",
            "hostid": "10084",
            "name": "Load average (15m avg)",
            "key_": "system.cpu.load[all,avg15]",
            "delay": "1m",
            "history": "7d",
            "trends": "365d",
            "status": "0",
            "value_type": "0",
            "trapper_hosts": "",
            "units": "",
            "logtimefmt": "",
            "templateid": "42219",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "0",
            "interfaceid": "1",
            "description": "",
            "inventory_link": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "timeout": "3s",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "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": "0",
            "prevvalue": "0"
        },
        {
            "itemid": "42249",
            "type": "0",
            "snmp_oid": "",
            "hostid": "10084",
            "name": "Load average (1m avg)",
            "key_": "system.cpu.load[all,avg1]",
            "delay": "1m",
            "history": "7d",
            "trends": "365d",
            "status": "0",
            "value_type": "0",
            "trapper_hosts": "",
            "units": "",
            "logtimefmt": "",
            "templateid": "42209",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "0",
            "interfaceid": "1",
            "description": "",
            "inventory_link": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "timeout": "3s",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "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": "0",
            "prevvalue": "0"
        },
        {
            "itemid": "42257",
            "type": "0",
            "snmp_oid": "",
            "hostid": "10084",
            "name": "Load average (5m avg)",
            "key_": "system.cpu.load[all,avg5]",
            "delay": "1m",
            "history": "7d",
            "trends": "365d",
            "status": "0",
            "value_type": "0",
            "trapper_hosts": "",
            "units": "",
            "logtimefmt": "",
            "templateid": "42217",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "0",
            "interfaceid": "1",
            "description": "",
            "inventory_link": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "timeout": "3s",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "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": "0",
            "prevvalue": "0"
        },
        {
            "itemid": "42260",
            "type": "0",
            "snmp_oid": "",
            "hostid": "10084",
            "name": "Number of CPUs",
            "key_": "system.cpu.num",
            "delay": "1m",
            "history": "7d",
            "trends": "365d",
            "status": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "units": "",
            "logtimefmt": "",
            "templateid": "42220",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "0",
            "interfaceid": "1",
            "description": "",
            "inventory_link": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "timeout": "3s",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "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": "0",
            "prevvalue": "0"
        }
    ],
    "id": 1
}
```

[comment]: # ({/6e846eda-59b84d93})

[comment]: # ({3f2f1b9f-674b0856})
#### Cercar elements dependents, per clau

Recupera tots els elements dependents de l'equip amb ID "10116" donada una clau que conté el nom "apache".

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "item.get",
    "params": {
        "output": "extend",
        "hostids": "10116",
        "search": {
            "key_": "apache"
        },
        "filter": {
            "type": 18
        }
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "25550",
            "type": "18",
            "snmp_oid": "",
            "hostid": "10116",
            "name": "Days",
            "key_": "apache.status.uptime.days",
            "delay": "0",
            "history": "90d",
            "trends": "365d",
            "status": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "units": "",
            "logtimefmt": "",
            "templateid": "0",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "0",
            "interfaceid": "0",
            "description": "",
            "inventory_link": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "25545",
            "timeout": "3s",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "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": "0",
            "prevvalue": "0"
        },
        {
            "itemid": "25555",
            "type": "18",
            "snmp_oid": "",
            "hostid": "10116",
            "name": "Hours",
            "key_": "apache.status.uptime.hours",
            "delay": "0",
            "history": "90d",
            "trends": "365d",
            "status": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "units": "",
            "logtimefmt": "",
            "templateid": "0",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "0",
            "interfaceid": "0",
            "description": "",
            "inventory_link": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "25545",
            "timeout": "3s",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "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": "0",
            "prevvalue": "0"
        }
    ],
    "id": 1
}
```

[comment]: # ({/3f2f1b9f-674b0856})

[comment]: # ({37edd810-94dc4b21})
#### Trobar un element d'agent HTTP

Troba un element d'agent HTTP amb el tipus de cos XML per a un ID d'equip donat.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "item.get",
    "params": {
        "hostids": "10255",
        "filter": {
            "type": 19,
            "post_type": 3
        }
    },
    "id": 3,
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "28252",
            "type": "19",
            "snmp_oid": "",
            "hostid": "10255",
            "name": "template item",
            "key_": "ti",
            "delay": "30s",
            "history": "90d",
            "trends": "365d",
            "status": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "units": "",
            "logtimefmt": "",
            "templateid": "0",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "0",
            "interfaceid": "0",
            "description": "",
            "inventory_link": "0",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "timeout": "3s",
            "url": "localhost",
            "query_fields": [
                {
                    "mode": "xml"
                }
            ],
            "posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>",
            "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": 3
}
```

[comment]: # ({/37edd810-94dc4b21})

[comment]: # ({6697de6d-f4b01bbe})
#### Cercar elements amb regles de pretractament

Recuperar tots els elements i les seves regles de pretractament per un ID d'equip específic.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "item.get",
    "params": {
        "output": ["itemid", "name", "key_"],
        "selectPreprocessing": "extend",
        "hostids": "10254"
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "itemid": "23865",
        "name": "HTTP agent example JSON",
        "key_": "json",
        "preprocessing": [
            {
                "type": "12",
                "params": "$.random",
                "error_handler": "1",
                "error_handler_params": ""
            }
        ]
    },
    "id": 1
}
```

[comment]: # ({/6697de6d-f4b01bbe})

[comment]: # ({febb018b-d3276b35})
### Veieu també

- [Regla de descoberta](/manual/api/reference/discoveryrule/object#discovery_rule)
- [Gràfic](/manual/api/reference/graphitem/object#graph)
- [Equip](/manual/api/reference/host/object#host)
- [Interfície d'equip](/manual/api/reference/hostinterface/object#host_interface)
- [Trigger](/manual/api/reference/trigger/object#trigger)

[comment]: # ({/febb018b-d3276b35})

[comment]: # ({a6ef1d0f-a6ef1d0f})
### Font

CItem::get() in *ui/include/classes/api/services/CItem.php*.

[comment]: # ({/a6ef1d0f-a6ef1d0f})