Documentation
Table of Contents
triggerprototype.get
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
integer/array triggerprototype.get(object parameters)
El m¨¨tode permet recuperar prototips de triggers segons els ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs 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.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
(object) ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ que defineixen la sortida esperada.
el m¨¨tode admet els ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs seg¨¹ents.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| active | flag | Retorna nom¨¦s els prototips activats que pertanyen als equips monitoritzats. |
| discoveryids | ID/array | Retorna nom¨¦s prototips de triggers que pertanyen a les regles LLD donades. |
| functions | string/array | Retorna nom¨¦s triggers que empren les funcions donades. Consulteu la p¨¤gina trigger functions per obtindre una llista de funcions admeses. |
| grup | string | Retorna nom¨¦s prototips de triggers que pertanyen als equips dels grups donats. |
| groupids | ID/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 | ID/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 ´Ú³Ü²Ô³¦¾±¨® representen les funcions emprades a l'expressi¨® de trigger i tenen les propietats seg¨¹ents: functionid - (ID) ID de la ´Ú³Ü²Ô³¦¾±¨®;itemid - (ID) ID de l'element emprat a la ´Ú³Ü²Ô³¦¾±¨®;´Ú³Ü²Ô³¦¾±¨® - (string) nom de la ´Ú³Ü²Ô³¦¾±¨®;±è²¹°ù¨¤³¾±ð³Ù°ù±ð - El ±è²¹°ù¨¤³¾±ð³Ù°ù±ð (string) que s'ha passat a la ´Ú³Ü²Ô³¦¾±¨®. El ±è²¹°ù¨¤³¾±ð³Ù°ù±ð 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. |
| selectHosts | query | Retorna els equips als quals pertany el prototip de trigger a la propietat equips. |
| selectItems | query | Retorna els elements i els prototips d'elements emprats pel prototip de trigger a la propietat elements. |
| selectTags | query | Retorna les etiquetes del prototip de trigger a la propietat etiquetes. |
| selectTemplateGroups | query | Retorna els grups de plantilles als quals pertany el prototip del trigger a la propietat templategroups. |
| 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, priority i discovered. |
| countOutput | boolean | Aquests ±è²¹°ù¨¤³¾±ð³Ù°ù±ðs es descriuen als comentaris de refer¨¨ncia. |
| 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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ð ¨¦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 ±è²¹°ù¨¤³¾±ð³Ù°ù±ð
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.
{
"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
{
"jsonrpc": "2.0",
"method": "triggerprototype.get",
"params": {
"output": [
"triggerid",
"description"
]
"selectTags": "extend",
"triggerids": [
"17373"
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"triggerid": "17373",
"description": "L'espai lliure de disc ¨¦s inferior al 20% al volum {#FSNAME}",
"tags": [
{
"tag": "volume",
"value": "{#FSNAME}"
},
{
"tag": "type",
"value": "{#FSTYPE}"
}
]
}
],
"id": 1
}Veieu tamb¨¦
Font
CTriggerPrototype::get() in ui/include/classes/api/services/CTriggerPrototype.php.