triggerprototype.get

Descripció

integer/array triggerprototype.get(object parameters)

El mètode permet recuperar prototipus 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.| |selectGroups|query|Retorna els grups d'equips als quals pertany el prototip del trigger a la propietat [grups](/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).| |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 perhost.| |sortfield|string/array|Ordena el resultat per les propietats donades.

Valors possibles:
triggerid,description,statusipriority.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodesget`, 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

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

Recuperar 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"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "triggerid": "13272",
                   "expression": "{12598}<20",
                   "description": "Free inodes is less than 20% on volume {#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": "Free disk space is less than 20% on volume {#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

Petició:

{
           "jsonrpc": "2.0",
           "method": "triggerprototype.get",
           "params": {
               "output": [
                   "triggerid",
                   "description"
               ]
               "selectTags": "extend",
               "triggerids": [
                   "17373"
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "triggerid": "17373",
                   "description": "Free disk space is less than 20% on volume {#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.