triggerprototype.get

Опис

integer/array triggerprototype.get(object parameters)

Метод омогућава да се пронађу прототипови окидача према датим параметрима.

Овај метод је доступан корисницима било које врсте. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Улоге корисника за више информација.

Параметри

(објекат) Параметри који дефинишу жељени излаз.

Метода подржава следеће параметре.

Parameter Type Description
active flag Враћа само омогућене прототипове окидача који припадају праћеним домаћинима.
discoveryids ID/array Враћа само прототипове окидача који припадају датим LLD правилима.
functions string/array Враћа само окидаче који користе дате функције.

Погледајте страницу Подржане функције за листу подржаних функција.
group string Враћа само прототипове окидача који припадају домаћинима или шаблонима из група домаћина или група шаблона са датим именом.
groupids ID/array Враћа само прототипове окидача који припадају домаћинима или шаблонима из датих група домаћина или група шаблона.
host string Врати само прототипове покретача који припадају домаћинима са датим именом.
hostids ID/array Врати само прототипове покретача који припадају датим домаћинима.
inherited boolean Ако је подешено на true, врати само прототипове покретача наслеђене из шаблона.
maintenance boolean Ако је подешено на true, врати само омогућене прототипове покретача који припадају домаћинима у одржавању.
min_severity integer Врати само прототипове покретача са озбиљношћу већом или једнаком датој озбиљности.
monitored flag Врати само омогућене прототипове покретача који припадају праћеним домаћинима и садрже само омогућене ставке.
templated boolean Ако је подешено на true, врати само прототипове покретача који припадају шаблонима.
templateids ID/array Врати само прототипове покретача који припадају датим шаблонима.
triggerids ID/array Врати само прототипове покретача са датим ID-овима.
expandExpression flag Прошири функције и макрое у изразу окидача.
selectDependencies query Врати прототипове окидача и окидаче од којих прототип окидача зависи у својству dependencies.
selectDiscoveryRule query Врати LLD правило којем прототип окидача припада у својству discoveryRule.
selectDiscoveryRulePrototype query Врати својство discoveryRulePrototype са родитељским прототипом LLD правила којем прототип окидача припада.
selectFunctions query Враћа функције коришћене у прототипу окидача у својству functions.

Објекти функција представљају функције коришћене у изразу окидача и имају следећа својства:
functionid - (ID) ID функције;
itemid - (ID) ID ставке која се користи у функцији;
function - (string) назив функције;
parameter - (string) параметар прослеђен функцији. Параметар упита се замењује симболом $ у враћеном стрингу.
selectHostGroups query Враћа групе домаћина којима прототип окидача припада у својству hostgroups.
selectHosts query Враћа хостове којима прототип окидача припада у својству hosts.
selectItems query Врати ставке и прототипове ставки који користе прототип окидача у својству items.
selectTags query Врати ознаке прототипа окидача у својству tags.
selectTemplateGroups query Врати групе шаблона којима прототип окидача припада у својству templategroups.
филтер објекат Враћа само оне резултате који се тачно подударају са датим филтером.

Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за упоређивање.

Не подржава својства text тип података.

Подржава додатна својства:
host - технички назив домаћина којем припада прототип окидача;
hostid - ID домаћина којем припада прототип окидача.
limitSelects integer Ограничава број записа које враћају подизбори.

Односи се на следеће подизборе:
selectHosts - резултати ће бити сортирани по host.
sortfield string/array Сортира резултат по датим својствима.

Могуће вредности: triggerid, description, status, priority, discovered.
countOutput boolean Ови параметри су описани у референтном коментару.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Повратне вредности

(integer/array) Враћа или:

  • низ објеката;
  • број преузетих објеката, ако је коришћен параметар countOutput.

Примери

Преузми прототипове окидача из LLD правила

Преузми све прототипове окидача и њихове функције из LLD правила.

Захтев:

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

Одговор:

{
     "jsonrpc": "2.0",
     "result": [
     {
     "triggerid": "13272",
     "expression": "{12598}<20",
     "description": "Free inodes is less than 20% on volume {#FSNAME}",
     "url": "",
     "status": "0",
     "value": "0",
     "priority": "2",
     "lastchange": "0",
     "comments": "",
     "error": "",
     "templateid": "0",
     "type": "0",
     "state": "0",
     "flags": "2",
     "recovery_mode": "0",
     "recovery_expression": "",
     "correlation_mode": "0",
     "correlation_tag": "",
     "manual_close": "0",
     "opdata": "",
     "discover": "0",
     "event_name": "",
     "uuid": "6ce467d05e8745409a177799bed34bb3",
     "url_name": "",
     "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",
     "value": "0",
     "priority": "2",
     "lastchange": "0",
     "comments": "",
     "error": "",
     "templateid": "0",
     "type": "0",
     "state": "0",
     "flags": "2",
     "recovery_mode": "0",
     "recovery_expression": "",
     "correlation_mode": "0",
     "correlation_tag": "",
     "manual_close": "0",
     "opdata": "",
     "discover": "0",
     "event_name": "",
     "uuid": "74a1fc62bfe24b7eabe4e244c70dc384",
     "url_name": "",
     "functions": [
     {
     "functionid": "13500",
     "itemid": "22686",
     "triggerid": "13266",
     "parameter": "$","function": "last"
     }
     ]
     }
     ],
     "id": 1
}

Преузимање одређеног прототипа окидача са ознакама

Захтев:

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

Одговор:

{
     "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
}

Такође погледајте

Извор

CTriggerPrototype::get() in ui/include/classes/api/services/CTriggerPrototype.php.