Documentation
Table of Contents
discoveryruleprototype.get
Descripció
integer/array discoveryruleprototype.get(object parameters)
El mètode permet recuperar prototips de regles LLD segons els paràmetres proveïts.
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.
Paràmetres
(object) Paràmetres que defineixen la sortida esperada.
El mètode admet els paràmetres següents.
| Paràmetre | Tipus | Descripció |
|---|---|---|
| itemids | ID/matriu | Retorna només prototips de regles LLD amb els ID donats. |
| groupids | ID/matriu | Retorna només prototips de regles LLD que pertanyen als equips dels grups donats. |
| hostids | ID/matriu | Retorna només prototips de regles LLD que pertanyen als equips donats. |
| inherited | booleà | Si es defineix a true, retorna només prototips de regles LLD heretades d'una plantilla. |
| interfaceids | ID/matriu | Retorna només prototips de regles LLD que utilitzen les interfícies d'equip donades. |
| monitored | booleà | Si es defineix a true, només retorna els prototips de regles LLD habilitats que pertanyen a equips monitorats. |
| templated | booleà | Si es defineix a true, només retorna els prototips de regles LLD que pertanyen a plantilles. |
| templateids | ID/matriu | Només retorna els prototips de regles LLD que pertanyen a les plantilles donades. |
| selectDiscoveryRule | consulta | Retorna una propietat discoveryRule amb la regla LLD principal del prototip de regla LLD. |
| selectDiscoveryRulePrototype | consulta | Retorna una propietat discoveryRulePrototype amb el prototip de regla LLD principal del prototip de regla LLD. |
| selectDiscoveryRulePrototypes | consulta | Retorna una propietat discoveryRulePrototypes amb prototips de regla LLD fill que pertanyen al prototip de regla LLD.Admet count. |
| selectFilter | consulta | Retorna una propietat filter amb dades del filtre utilitzat pel prototip de regla LLD. |
| selectGraphs | consulta | Retorna una propietat graphs amb prototips de gràfics que pertanyen al prototip de regla LLD.Admet count. |
| selectHostPrototypes | consulta | Retorna una propietat hostPrototypes amb prototips d'equip que pertanyen al prototip de regla LLD.Admet count. |
| selectHosts | consulta | Retorna una propietat hosts amb una matriu d'equips als quals pertany el prototip de regla LLD. |
| selectItems | consulta | Retorna una propietat items amb prototips d'elements que pertanyen al prototip de regla LLD.Admet count. |
| selectTriggers | consulta | Retorna una propietat triggers amb prototips de disparador que pertanyen al prototip de regla LLD.Admet count. |
| selectLLDMacroPaths | consulta | Retorna una propietat lld_macro_paths amb una llista de macros LLD i camins als valors assignats a cada macro corresponent. |
| selectPreprocessing | consulta | Retorna una propietat preprocessing amb opcions de preprocessament de prototips de regles LLD. |
| selectOverrides | consulta | Retorna una propietat lld_rule_overrides amb una llista de filtres, condicions i operacions de substitució que es realitzen sobre objectes prototip. |
| filter | object | Retorna només els resultats que coincideixin exactament amb el filtre donat. Accepta un objecte, on les claus són noms de propietats i els valors són un valor únic o una matriu de valors amb els quals coincidir. No admet propietats de text tipus de dades.Admet propietats addicionals: host - nom tècnic de l'equip al qual pertany el prototip de regla LLD. |
| limitSelects | integer | Limita el nombre de registres retornats per les subseleccions. S'aplica a les subseleccions següents: selectItems, selectGraphs, selectTriggers. |
| sortfield | cadena/matriu | Ordena el resultat per les propietats donades. Valors possibles: itemid, name, key_, delay, type, status. |
| countOutput | booleà | Aquests paràmetres es descriuen al comentari de referència. |
| editable | booleà | |
| excludeSearch | booleà | |
| limit | integer | |
| output | consulta | |
| preservekeys | booleà | |
| search | object | |
| searchByAny | booleà | |
| searchWildcardsEnabled | booleà | |
| sortorder | cadena/matriu | |
| startSearch | booleà |
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.
Exemples
Recuperació de prototips de regles de descoberta d'un equip
Recupera tots els prototips de regles de descoberta per a un ID d'equip específic.
{
"jsonrpc": "2.0",
"method": "discoveryruleprototype.get",
"params": {
"hostids": "10084"
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"itemid": "47253",
"type": "23",
"snmp_oid": "",
"hostid": "10084",
"name": "Discover tablespaces for {#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
}Veieu també
Font
CDiscoveryRulePrototype::get() in ui/include/classes/api/services/CDiscoveryRulePrototype.php.