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 ставке која се користи у функцији;
function - (string) назив функције;
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.
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",
            "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.