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 Ови параметри који су заједнички за све методе get су детаљно описани у референца коментара.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean
selectGroups
(deprecated)
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.