prototipodeitem.obtener

Descripción

integer/array hostprototype.get(object parameters)

El método permite recuperar prototipos de host de acuerdo con los parámetros dados.

Este método está disponible para usuarios de cualquier tipo. Permisos para activar el método se puede revocar en los ajustes de roles de usuario. Ver User roles para más información.

Parámetros

(object) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro Tipo Descripción
discoveryids cadena/matriz Devuelve solo prototipos de items que pertenecen a las reglas LLD dadas.
graphids cadena/matriz Devuelve solo los prototipos de items que se utilizan en los prototipos de gráficos dados.
hostids cadena/matriz Devuelve solo prototipos de items que pertenecen a los hosts dados.
heredado booleano Si se establece en "verdadero", devuelve solo prototipos de items heredados de una template.
itemids cadena/matriz Devuelve solo prototipos de items con los ID proporcionados.
monitoreado booleano Si se establece en "verdadero", devolverá solo los prototipos de elementos habilitados que pertenecen a hosts monitoreados.
templado booleano Si se establece en "verdadero", devuelve solo prototipos de elementos que pertenecen a plantillas.
templateids cadena/matriz Devuelve solo prototipos de items que pertenecen a las templates dadas.
triggerids cadena/matriz Devuelve solo los prototipos de items que se utilizan en los prototipos de trigger de dados.
selectDiscoveryRule query Devuelve una propiedad discoveryRule con la regla de descubrimiento de bajo nivel a la que pertenece el prototipo del item.
selectGraphs query Devuelve una propiedad manual/api/reference/graphprototype/object#graph_prototype con prototipos de gráficas en los que se utiliza el prototipo del item.< br>
Soporta count.
selectHosts consulta Devuelve una propiedad hosts con una matriz de hosts a los que pertenece el prototipo del item.
selectTags consulta Devuelve las etiquetas de prototipo de item en la propiedad tags.
selectTriggers consulta Devuelve una propiedad triggers con prototipos de trigger en los que se utiliza el prototipo del item.

Admite count.
selectPreprocessing consulta Devuelve una propiedad de preprocessing con opciones de preprocesamiento de items.

Tiene las siguientes propiedades:
tipo - (cadena) El tipo de opción de preprocesamiento:
1 - Multiplicador personalizado;
2 - Recorte derecho;
3 - Recorte izquierdo;
4 - Recortar;
5 - Coincidencia de expresiones regulares;< br>6 - Booleano a decimal;
7 - Octal a decimal;
8 - Hexadecimal a decimal;
9 - Cambio simple;
10 - Cambio por segundo;
11 - XML XPath ;
12 - JSONPath;
13 - Dentro del rango;
14 - Coincide con la expresión regular;
15 - No coincide con la expresión regular;
16 - Comprueba si hay errores en JSON;
17 - Verificar errores en XML;
18 - Verificar errores usando expresiones regulares;
19 - Descartar sin cambios;
20 - Descartar sin cambios con un latido;
21 - JavaScript;
22 - Patrón de Prometheus;
23 - Prometheus a JSON;
24 - CSV a JSON;
25 - Reemplazar;
26 - Verificar valor no admitido;
27- XML a JSON.<br >
params - (string) Parámetros adicionales utilizados por la opción de preprocesamiento. Múltiples parámetros están separados por el carácter LF (\n).
error_handler - (string) Tipo de acción utilizado en caso de falla en el paso de preprocesamiento:
0 - El mensaje de error lo establece el Zabbix Server;<br >1 - Descartar valor;
2 - Establecer valor personalizado;
3 - Establecer mensaje de error personalizado.

error_handler_params - (string) Parámetros del controlador de errores.
selectValueMap consulta Devuelve una propiedad valuemap con el mapa de valores del prototipo del item.
filtro objeto Devuelve sólo aquellos resultados que coinciden exactamente con el filtro dado.

Acepta una matriz, donde las claves son nombres de propiedades y los valores son un valor único o una matriz de valores con los que comparar.

Admite filtros adicionales:
host: nombre técnico del host al que pertenece el prototipo del item.
limitSelects número entero Limita el número de registros devueltos por las subselecciones.

Se aplica a las siguientes subselecciones:
selectGraphs: los resultados se ordenarán por nombre;
selectTriggers: resultados se ordenará por descripción.
sortfield cadena/matriz Ordena el resultado por las propiedades dadas.

Los valores posibles son: itemid, name, key_, delay, type y status.
countOutput booleano Estos parámetros, que son comunes para todos los métodos get, se describen en detalle en el reference commentary.
editable booleano
excluirBuscar booleano
límite entero
salida consulta
preservekeys booleano
buscar objeto
searchByAny booleano
searchWildcardsEnabled booleano
clasificación cadena/matriz
iniciarBuscar booleano

Valores de retorno

(integer/array) Devuelve:

  • una matriz de objetos;
  • el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperar prototipos de item de una regla LLD

Recupere todos los prototipos de item para una ID de regla LLD específica.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.get",
           "params": {
               "output": "extend",
               "discoveryids": "27426"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "itemid": "23077",
                   "type": "0",
                   "snmp_oid": "",
                   "hostid": "10079",
                   "name": "Incoming network traffic on en0",
                   "key_": "net.if.in[en0]",
                   "delay": "1m",
                   "history": "1w",
                   "trends": "365d",
                   "status": "0",
                   "value_type": "3",
                   "trapper_hosts": "",
                   "units": "bps",
                   "logtimefmt": "",
                   "templateid": "0",
                   "valuemapid": "0",
                   "params": "",
                   "ipmi_sensor": "",
                   "authtype": "0",
                   "username": "",
                   "password": "",
                   "publickey": "",
                   "privatekey": "",
                   "interfaceid": "0",
                   "description": "",
                   "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",
                   "discover": "0",
                   "uuid": "",
                   "parameters": []
               },
               {
                   "itemid": "10010",
                   "type": "0",
                   "snmp_oid": "",
                   "hostid": "10001",
                   "name": "Processor load (1 min average per core)",
                   "key_": "system.cpu.load[percpu,avg1]",
                   "delay": "1m",
                   "history": "1w",
                   "trends": "365d",
                   "status": "0",
                   "value_type": "0",
                   "trapper_hosts": "",
                   "units": "",
                   "logtimefmt": "",
                   "templateid": "0",
                   "valuemapid": "0",
                   "params": "",
                   "ipmi_sensor": "",
                   "authtype": "0",
                   "username": "",
                   "password": "",
                   "publickey": "",
                   "privatekey": "",
                   "interfaceid": "0",
                   "description": "The processor load is calculated as system CPU load divided by number of CPU cores.",
                   "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",
                   "lastclock": "0",
                   "lastns": "0",
                   "lastvalue": "0",
                   "prevvalue": "0",
                   "discover": "0",
                   "uuid": "",
                   "parameters": []
               }
           ],
           "id": 1
       }

Encontrar un item dependiente dependent item

Encuentre un item Dependiente para el item con ID "25545".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "item.get",
           "params": {
               "output": "extend",
               "filter": {
                   "type": "18",
                   "master_itemid": "25545"
               },
               "limit": "1"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "itemid": "25547",
                   "type": "18",
                   "snmp_oid": "",
                   "hostid": "10116",
                   "name": "Seconds",
                   "key_": "apache.status.uptime.seconds",
                   "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": "",
                   "interfaceid": "0",
                   "description": "",
                   "evaltype": "0",
                   "master_itemid": "25545",
                   "jmx_endpoint": "",
                   "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",
                   "discover": "0",
                   "uuid": "",
                   "parameters": []
               }
           ],
           "id": 1
       }

Encontrar un prototipo de item de agente HTTP

Busque prototipo de item de agente HTTP con método de solicitud HEAD para ID de host específico.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.get",
           "params": {
               "hostids": "10254",
               "filter": {
                   "type": "19",
                   "request_method": "3"
               }
           },
           "id": 17,
           "auth": "d678e0b85688ce578ff061bd29a20d3b"
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "itemid": "28257",
                   "type": "19",
                   "snmp_oid": "",
                   "hostid": "10254",
                   "name": "discovered",
                   "key_": "item[{#INAME}]",
                   "delay": "{#IUPDATE}",
                   "history": "90d",
                   "trends": "30d",
                   "status": "0",
                   "value_type": "3",
                   "trapper_hosts": "",
                   "units": "",
                   "logtimefmt": "",
                   "templateid": "28255",
                   "valuemapid": "0",
                   "params": "",
                   "ipmi_sensor": "",
                   "authtype": "0",
                   "username": "",
                   "password": "",
                   "publickey": "",
                   "privatekey": "",
                   "interfaceid": "2",
                   "description": "",
                   "evaltype": "0",
                   "jmx_endpoint": "",
                   "master_itemid": "0",
                   "timeout": "3s",
                   "url": "{#IURL}",
                   "query_fields": [],
                   "posts": "",
                   "status_codes": "",
                   "follow_redirects": "0",
                   "post_type": "0",
                   "http_proxy": "",
                   "headers": [],
                   "retrieve_mode": "0",
                   "request_method": "3",
                   "output_format": "0",
                   "ssl_cert_file": "",
                   "ssl_key_file": "",
                   "ssl_key_password": "",
                   "verify_peer": "0",
                   "verify_host": "0",
                   "allow_traps": "0",
                   "discover": "0",
                   "uuid": "",
                   "parameters": []
               }
           ],
           "id": 17
       }

Ver también

Fuente

CItemPrototype::get() en ui/include/classes/api/services/CItemPrototype.php.