discoveryruleprototype.get

Descripción

integer/array discoveryruleprototype.get(parámetros del objeto)

El método permite recuperar prototipos de reglas LLD según los parámetros dados.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para obtener más información.

Parámetros

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

El método admite los siguientes parámetros.

Parámetro	Tipo	Descripción
discoveryids	ID/array	Devolver solo prototipos de reglas LLD que pertenezcan a las reglas LLD o prototipos de reglas LLD indicados.
itemids	ID/array	Devolver solo prototipos de reglas LLD con los IDs indicados.
groupids	ID/array	Devolver solo prototipos de reglas LLD que pertenezcan a los equipos de los grupos indicados.
hostids	ID/array	Devolver solo prototipos de reglas LLD que pertenezcan a los equipos indicados.
inherited	booleano	Si se establece en `true`, devolver solo prototipos de reglas LLD heredados de una plantilla.
interfaceids	ID/array	Devolver solo prototipos de reglas LLD que utilicen las interfaces de equipo indicadas.
monitored	booleano	Si se establece en `true`, devolver solo prototipos de reglas LLD habilitados que pertenezcan a equipos monitorizados.
templated	booleano	Si se establece en `true`, devolver solo prototipos de reglas LLD que pertenezcan a plantillas.
templateids	ID/array	Devolver solo prototipos de reglas LLD que pertenezcan a las plantillas indicadas.
selectDiscoveryRule	consulta	Devolver una propiedad `discoveryRule` con la regla LLD principal del prototipo de regla LLD. Devolverá una respuesta vacía si el principal es un prototipo de regla de descubrimiento.
selectDiscoveryRulePrototype	consulta	Devolver una propiedad `discoveryRulePrototype` con el prototipo de regla LLD principal del prototipo de regla LLD. Devolverá una respuesta vacía si el principal es una regla de descubrimiento (no prototipo).
selectDiscoveryRulePrototypes	consulta	Devolver una propiedad `discoveryRulePrototypes` con los prototipos de reglas LLD hijos que pertenecen al prototipo de regla LLD. Admite `count`.
selectFilter	consulta	Devolver una propiedad `filter` con los datos del filtro utilizado por el prototipo de regla LLD.
selectGraphs	consulta	Devolver una propiedad `graphs` con los prototipos de gráficos que pertenecen al prototipo de regla LLD. Admite `count`.
selectHostPrototypes	consulta	Devolver una propiedad `hostPrototypes` con los prototipos de equipo que pertenecen al prototipo de regla LLD. Admite `count`.
selectHosts	consulta	Devolver una propiedad `hosts` con un array de equipos a los que pertenece el prototipo de regla LLD.
selectItems	consulta	Devolver una propiedad `items` con los prototipos de métricas que pertenecen al prototipo de regla LLD. Admite `count`.
selectTriggers	consulta	Devolver una propiedad `triggers` con los prototipos de disparadores que pertenecen al prototipo de regla LLD. Admite `count`.
selectLLDMacroPaths	consulta	Devolver una propiedad `lld_macro_paths` con una lista de macros LLD y rutas a los valores asignados a cada macro correspondiente.
selectPreprocessing	consulta	Devolver una propiedad `preprocessing` con las opciones de preprocesamiento del prototipo de regla LLD.
selectOverrides	consulta	Devolver una propiedad `lld_rule_overrides` con una lista de filtros de sobrescritura, condiciones y operaciones que se realizan sobre los objetos prototipo.
filter	objeto	Devolver solo aquellos resultados que coincidan exactamente con el filtro indicado. Acepta un objeto, donde las claves son nombres de propiedades y los valores son un único valor o un array de valores con los que comparar. No admite propiedades de tipo de dato `text` data type. Admite propiedades adicionales: `host` - nombre técnico del equipo al que pertenece el prototipo de regla LLD.
limitSelects	entero	Limita el número de registros devueltos por subconsultas. Se aplica a las siguientes subconsultas: `selectItems`, `selectGraphs`, `selectTriggers`.
sortfield	string/array	Ordenar el resultado por las propiedades indicadas. Valores posibles: `itemid`, `name`, `key_`, `delay`, `type`, `status`.
countOutput	booleano	Estos parámetros se describen en el comentario de referencia.
editable	booleano
excludeSearch	booleano
limit	entero
output	consulta
preservekeys	booleano
search	objeto
searchByAny	booleano
searchWildcardsEnabled	booleano
sortorder	string/array
startSearch	booleano

Valores de retorno

(integer/array) Devuelve:

un array de objetos;
el número de objetos recuperados, si se ha utilizado el parámetro countOutput.

Ejemplos

Recuperar prototipos de reglas de descubrimiento de un equipo

Recupera todos los prototipos de reglas de descubrimiento para un ID de equipo específico.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "discoveryruleprototype.get",
           "params": {
               "hostids": "10084"
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "itemid": "47253",
                   "type": "23",
                   "snmp_oid": "",
                   "hostid": "10084",
                   "name": "Descubrir tablespaces para {#DB}",
                   "key_": "db.tablespace.discovery[{#DB}]",
                   "delay": "0",
                   "history": "31d",
                   "trends": "365d",
                   "status": "0",
                   "value_type": "4",
                   "trapper_hosts": "",
                   "units": "",
                   "logtimefmt": "",
                   "templateid": "0",
                   "valuemapid": "0",
                   "params": "",
                   "ipmi_sensor": "",
                   "authtype": "0",
                   "username": "",
                   "password": "",
                   "publickey": "",
                   "privatekey": "",
                   "flags": "3",
                   "interfaceid": "0",
                   "description": "",
                   "inventory_link": "0",
                   "lifetime": "7d",
                   "jmx_endpoint": "",
                   "master_itemid": "0",
                   "timeout": "",
                   "url": "",
                   "query_fields": [],
                   "posts": "",
                   "status_codes": "200",
                   "follow_redirects": "1",
                   "post_type": "0",
                   "http_proxy": "",
                   "headers": [],
                   "retrieve_mode": "0",
                   "request_method": "0",
                   "ssl_cert_file": "",
                   "ssl_key_file": "",
                   "ssl_key_password": "",
                   "verify_peer": "0",
                   "verify_host": "0",
                   "allow_traps": "0",
                   "discover": "0",
                   "uuid": "",
                   "lifetime_type": "0",
                   "enabled_lifetime_type": "2",
                   "enabled_lifetime": "0",
                   "parameters": []
               }
           ],
           "id": 1
       }

Véase también

Fuente

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

Documentation