Documentation
Table of Contents
triggerprototype.get
Опис
integer/array triggerprototype.get(object parameters)
Метод омогућава да се пронађу прототипови окидача према датим параметрима.
Овај метод је доступан корисницима било које врсте. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Улоге корисника за више информација.
Параметри
(object) Параметри који дефинишу жељени излаз.
Метод подржава следеће параметре.
| 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.| |selectFunctions|query|Враћа функције које се користе у прототипу окидача у својству functions.
Објекти функције представљају функције које се користе у изразу окидача и имају следећа својства:functionid - (ID) ID функције;itemid - (ID) ID ставке која се користи у функцији;name - (string) назив функције (враћа се као својство function);parameter - (string) параметар прослеђен функцији. Параметар упита је замењен симболом $ у враћеном низу.| |selectHostGroups|query|Враћа групе домаћина којима припада прототип окидача у својству hostgroups. | |selectHosts|query|Враћа домаћине којима припада прототип окидача у својство hosts.| |selectItems|query|Повратне ставке и прототипови ставки користили су прототип окидача у својство items.| |selectTags|query|Враћа ознаке прототипа окидача у својство tags.| |selectTemplateGroups|query|Враћа групе шаблона којима припада прототип окидача у својство templategroups.| |filter|object|Враћа само оне резултате који тачно одговарају датом филтеру.
Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за подударање.
Не подржава својства 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|^| |selectGroups
(застарело)|query|Ово параметар је застарео, користите selectHostGroups или selectTemplateGroups уместо тога.
Враћа групе домаћина и групе шаблона којима припада прототип окидача у својству groups.|
Повратне вредности
(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",
"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",
"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.