triggerprototype.get

Descripció

integer/array triggerprototype.get(object parameters)

El mètode permet recuperar prototips de triggers 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ó
active	flag	Retorna només els prototips activats que pertanyen als equips monitoritzats.
discoveryids	string/array	Retorna només prototips de triggers que pertanyen a les regles LLD donades.
functions	string/array	Retorna només triggers que utilitzen les funcions donades. Consulteu la pàgina trigger functions per obtenir una llista de funcions admeses.
grup	string	Retorna només prototips de triggers que pertanyen als equips dels grups donats.
groupids	string/array	Retorna només prototips de triggers que pertanyen als equips dels grups donats.
host	string	Retorna només prototips de triggers que pertanyen als equips donats.
hostids	string/array	Retorna només els prototips de triggers que pertanyen als equips donats.
inherited	boolean	Si s'estableix a `true`, només retorna els prototips de triggers heretats d'una plantilla.
manteinance	boolean	Si s'estableix a `true`, només es retornen els prototips de triggers que pertanyen als equips en manteniment.
min_severity	integer	Retorn només els prototips de triggers la gravetat dels quals és superior o igual a la gravetat donada.
monitored	flag	Retorna només prototips de triggers activats que pertanyen a equips supervisats i que només contenen elements activats.
template	boolean	Si s'estableix com a `true`, només retorna prototips de triggers que pertanyen a plantilles.
templateids	string/array	Retorna només prototips de triggers que pertanyen a les plantilles donades.
triggerids	string/array	Retorna només els prototips de triggers amb els ID donats.
expandExpression	flag	Amplieu les funcions i les macros a l'expressió de trigger.
selectDependencies	query	Retorna els prototips del trigger i els triggers dels quals depèn el prototip del trigger a la propietat `dependencies`.
selectDiscoveryRule	query	Retorna la regla LLD a la qual pertany el prototip del trigger.
selectFunctions	query	Retorna les funcions emprades en el prototip de trigger a la propietat `functions`. Els objectes de funció representen les funcions emprades a l'expressió de trigger i tenen les propietats següents: `functionid` - * (cadena)* ID de la funció; `itemid` - (cadena) ID de l'element emprat a la funció; `funció` - (cadena) nom de la funció; `paràmetre' - El paràmetre (cadena) que s'ha passat a la funció. El paràmetre de consulta es substitueix pel símbol`$a la cadena retornada.\| \|selectHostGroups\|query\|Retorna els grups d'equips als quals pertany el prototip del trigger a la propietat [hostgroups](/manual/api/reference/hostgroup/object).\| \|selectHosts\|query\|Retorna els equips als quals pertany el prototip de trigger a la propietat [equips](/manual/api/reference/host/object).\| \|selectItems\|query\|Retorna els elements i els prototips d'elements emprats pel prototip de trigger a la propietat [elements](/manual/api/reference/item/object).\| \|selectTags\|query\|Retorna les etiquetes del prototip de trigger a la propietat [etiquetes](/manual/api/reference/triggerprototype/object#Trigger_prototype_tag).\| \|selectTemplateGroups\|query\|Retorna els grups de plantilles als quals pertany el prototip del trigger a la propietat [templategroups](/manual/api/reference/templategroup/object).\| \|filter\|object\|Només retorna resultats que coincideixen exactament amb el filtre donat. 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> Compatibilitat amb filtres addicionals:host`- nom tècnic de l'equip al qual pertany el prototip de trigger;`hostid`- ID de l'equip al qual pertany el prototip de trigger.\| \|limitSelects\|integer\|Limita el nombre de registres retornats per les subconsultes. S'aplica a les subseleccions següents:`selectHosts`: els resultats s'ordenaran per`host`.\| \|sortfield\|string/array\|Ordena el resultat per les propietats donades. Valors possibles:`triggerid`,`description`,`status`i`priority`.\| \|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\|^\| \|selectGroups (obsolet)\|query\|Aquest paràmetre és obsolet; si us plau, emprau`selectHostGroups`o`selectTemplateGroups`en el seu lloc. Retorna els grups d'equips i els grups de plantilles on el trigger pertany a la propietat`groups`.

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

Recuperar prototips de triggers a partir d'una regla LLD

Recupera tots els prototips de triggers i les seves funcions a partir d'una regla LLD.

Petició:

{
           "jsonrpc": "2.0",
           "method": "triggerprototype.get",
           "params": {
               "output": "extend",
               "selectFunctions": "extend",
               "discoveryids": "22450"
           },
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "triggerid": "13272",
                   "expression": "{12598}<20",
                   "description": "Els inodes lliures són inferiors al 20% al volum {#FSNAME}",
                   "url": "",
                   "status": "0",
                   "priority": "2",
                   "comments": "",
                   "templateid": "0",
                   "type": "0",
                   "flags": "2",
                   "recovery_mode": "0",
                   "recovery_expression": "",
                   "correlation_mode": "0",
                   "correlation_tag": "",
                   "manual_close": "0",
                   "opdata": "",
                   "discover": "0",
                   "functions": [
                       {
                           "functionid": "12598",
                           "itemid": "22454",
                           "triggerid": "13272",
                           "parameter": "$",
                           "function": "last"
                       }
                   ]
               },
               {
                   "triggerid": "13266",
                   "expression": "{13500}<20",
                   "description": "L'espai lliure de disc és inferior al 20% al volum {#FSNAME}",
                   "url": "",
                   "status": "0",
                   "priority": "2",
                   "comments": "",
                   "templateid": "0",
                   "type": "0",
                   "flags": "2",
                   "recovery_mode": "0",
                   "recovery_expression": "",
                   "correlation_mode": "0",
                   "correlation_tag": "",
                   "manual_close": "0",
                   "opdata": "",
                   "discover": "0",
                   "functions": [
                       {
                           "functionid": "13500",
                           "itemid": "22686",
                           "triggerid": "13266",
                           "parameter": "$",
                           "function": "last"
                       }
                   ]
               }
           ],
           "id": 1
       }

Recuperar un prototip de trigger específic amb etiquetes