[comment]: # translation:outdated
[comment]: # ({fc5b81d2-fc5b81d2})
# trigger.get
[comment]: # ({/fc5b81d2-fc5b81d2})
[comment]: # ({f493658b-e77e3d1e})
### Опис
`integer/array trigger.get(object parameters)`
Метода омогућава преузимање тригера према датим параметрима.
::: noteclassic
Овај метод је доступан корисницима било које врсте. Дозволе за позивање методе се могу опозвати у подешавањима улоге корисника. Погледајте [Улоге корисника](/manual/web_interface/frontend_sections/users/user_roles) за више информација.
:::
[comment]: # ({/f493658b-e77e3d1e})
[comment]: # ({b10eb44f-44938a82})
### Параметри
`(object)` Параметри који дефинишу жељени излаз.
Метод подржава следеће параметре.
|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|-- ----|
|triggerids|ID/array|Врати само окидаче са датим ID-ијевима.|
|groupids|ID/array|Врати само окидаче који припадају домаћинима или шаблонима из датих група домаћина или група шаблона.|
|templateids|ID/array|Врати само окидаче који припадају датим шаблонима.|
|hostids|ID/array|Врати само окидаче који припадају датим домаћинима.|
|itemids|ID/array|Врати само окидаче који садрже дате ставке.|
|functions|string/array|Врати само окидаче који користе дате функције.
Погледајте страницу [подржана функција](/manual/appendix/functions) за листу подржаних функција.|
|group|string|Врати само окидаче који припадају домаћинима или шаблонима из групе домаћина или групе шаблона са датим именом.|
|host|string|Врати само окидаче који припадају домаћину са датим техничким именом.|
|inherited|boolean|Ако је постављено на `true` врати само окидаче наслеђене из шаблона.|
|templated|boolean|Ако је постављено на `true` враћа само окидаче који припадају шаблонима.|
|dependent|boolean| Ако је подешено на `true`, враћају се само покретачи који имају зависности. Ако је подешено на `false `, враћају само окидаче који немају зависности.|
|monitored|flag|Врати само омогућене окидаче који припадају надгледаним домаћинима и садрже само омогућене ставке.|
|active|flag|Врати само омогућене окидаче који припадају надгледаним домачинима.|
|maintenance|boolean|Ако је постављено на `true` враћа само омогућене окидаче који припадају домаћинима у одржавању.|
|withUnacknowledgedEvents|flag|Врати само окидаче који имају непризнате догађаје.|
|withAcknowledgedEvents|flag|Врати само окидаче са свим потврђеним догађајима.|
|withLastEventUnacknowledged|flag|Врати само последњи догађај који није потврђен.|
|skipDependent|flag|Прескочи окидаче у стању проблема који зависе од других окидача. Имајте на уму да се други окидачи занемарују ако су онемогућени, имају онемогућене ставке или онемогућене домаћине ставки.|
|lastChangeSince|timestamp|Врати само окидаче који су променили стање након датог времена.|
|lastChangeTill|timestamp|Врати само окидаче који су променили своје стање пре датог времена.|
|only\_true|flag|Врати само окидаче који су недавно били у проблемском стању.|
|min\_severity|integer|Повратак само покреће са озбиљношћу већом или једнаком од дате озбиљности.|
|evaltype|integer|Правила за претрагу ознака.
Могуће вредности:
0 - (подразумевано) И/Или;
2 - Или.|
|tags|array|Врати само окидаче са датим ознакама. Тачно подударање по ознаци и претрага која се разликује од великих или малих слова по вредности ознаке у зависности од вредности оператора.
Формат: `[{"ознака": "", "вредност": "", " оператор": ""}, ...]`.
Празан низ враћа све покретаче.
Могући типови оператора:
0 - (подразумевано) Свиђа ми се;
1 – Једнако;<бр>2 – Не свиђа;
3 – Није једнако;
4 – Постоји;
5 – Не постоји.|
|expandComment|flag|Прошири макрое у опис окидача.|
|expandDescription|flag|Прошири макрое у имену окидача.|
|expandExpression|flag|Прошири функције и макрое у окидачу израз.|
|selectHostGroups|query|Врати групе домаћина којима окидач припада у својству [`hostgroups`](/manual/api/reference/hostgroup/object) property.|
|selectHosts|query|Врати хостове које окидач припада у [`хостс`](/мануал/апи/референце/хост/објецт) својство.|
|selectItems|query|Врати ставке које садржи окидач у својству [`items`](/manual/api/reference/item/object).|
|selectFunctions|query|Врати функције које се користе у окидачу у својства `функције`.
Објекти функције представљају функције које се користе у изразу окидача и имају следећа својства:
`functionid ` - `(ID)` ID функције;<бр>`itemid` - `(ID)` ID ставке која се користи у функцији;
`function ` - `(string)` име функције;
`parameter ` - `(string)` параметар прослеђен функцији. Параметар упита је замењен симболом `$` у враћеном низу.|
|selectDependencies|query|Повратни окидачи од којих зависи окидач у својству `dependencies `.|
|selectDiscoveryRule|query|Врати [правило откривања ниског нивоа](/manual/api/reference/discoveryrule/object#discovery_rule) који је креирао окидач у својству `discoveryRule`.|
|selectLastEvent|query|Врати последњи значајан догађај окидача у [`lastEvent`](/manual/api/reference/event/objectт).|
|selectTags|query|Врати ознаке окидача у својству [`tags `](/manual/api/reference/trigger/object#Trigger_tag) .|
|selectTemplateGroups|query|Врати групе шаблона којима окидач припада у [`templategroups`](/manual/api/reference/templategroup/object).|
|selectTriggerDiscovery|query|Врати објекат за откривање окидача у својству `triggerDiscovery`. Објекти откривања окидача повезују окидач са прототипом окидача од којег је креиран.
Има следећа својства:
`parent_triggerid` - `(ID)` ID прототипа окидача из којег је окидач је креиран;
`status ` - `(int)` статус откривања окидача:
0 - *(подразумевано)* окидач је откривен,
1 - окидач је више није откривено;
`ts_delete ` - `(timestamp)` време када ће окидач који више није откривен ће бити избрисан;
`ts_disable ` - `(timestamp)` време када окидач који више није откривен ће бити онемогућен;
`disable_source` - `(int)` индикатор да ли је окидач онемогућен LLD правилом или ручно:
0 - *(подразумевано)* онемогућено аутоматски,
1 - онемогућено LLD правилом.|
|filter|object|Врати само оне резултате који се тачно подударају са датим филтером.
Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за подударање.
Не подржава својства `text ` [тип податка](/manual/api/reference_commentary#data-types).
Подржава додатна својства:
`host` - техничко име домаћина којем окидач припада;
`hostid` - ID домаћина којем окидач припада.|
|limitSelects|integer|Ограничава број записа које враћају подизбори.
Односи се на следеће подселектује:
`selectHosts` - резултати ће бити сортирани по `host`.|
|sortfield|string/array|[Сортирање](/manual/api/reference_commentary#common_get_method_parameters) резултат према датим својствима.
Могуће вредности: `triggerid`, `description `, `status `, `priority `, `lastchange `, `hostname`.|
|countOutput|boolean|Ови параметри који су заједнички за све методе `get ` су детаљно описани у [референтном коментару](/manual/api/reference_commentary#common_get_method_parameters) страница.|
|editable|boolean|^|
|excludeSearch|boolean|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|
[comment]: # ({/b10eb44f-44938a82})
[comment]: # ({07ca11ca-7223bab1})
### Повратне вредности
`(integer/array)` Враћа или:
- низ објеката;
- број преузетих објеката, ако је коришћен параметар `countOutput `.
[comment]: # ({/07ca11ca-7223bab1})
[comment]: # ({b41637d2-b41637d2})
### Примери
[comment]: # ({/b41637d2-b41637d2})
[comment]: # ({d9d4c665-3d27e76d})
#### Преузимање података помоћу ID-ија окидача
Преузми све податке и функције које се користе у окидачу „14062“.
[Захтев](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "trigger.get",
"params": {
"triggerids": "14062",
"output": "extend",
"selectFunctions": "extend"
},
"id": 1
}
```
Одговор:
```json
{
"jsonrpc": "2.0",
"result": [
{
"triggerid": "14062",
"expression": "{13513}<10m",
"description": "{HOST.NAME} has been restarted (uptime < 10m)",
"url": "",
"status": "0",
"value": "0",
"priority": "2",
"lastchange": "0",
"comments": "The host uptime is less than 10 minutes",
"error": "",
"templateid": "10016",
"type": "0",
"state": "0",
"flags": "0",
"recovery_mode": "0",
"recovery_expression": "",
"correlation_mode": "0",
"correlation_tag": "",
"manual_close": "0",
"opdata": "",
"event_name": "",
"uuid": "",
"url_name": "",
"functions": [
{
"functionid": "13513",
"itemid": "24350",
"triggerid": "14062",
"parameter": "$",
"function": "last"
}
]
}
],
"id": 1
}
```
[comment]: # ({/d9d4c665-3d27e76d})
[comment]: # ({a6701c25-8a31301f})
#### Преузимање окидача у проблемском стању
Преузми ID, назив и озбиљност свих окидача у стању проблема и сортирај их по озбиљности у опадајућем редоследу.
[Захтев](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "trigger.get",
"params": {
"output": [
"triggerid",
"description",
"priority"
],
"filter": {
"value": 1
},
"sortfield": "priority",
"sortorder": "DESC"
},
"id": 1
}
```
Одговор:
```json
{
"jsonrpc": "2.0",
"result": [
{
"triggerid": "13907",
"description": "Zabbix self-monitoring processes < 100% busy",
"priority": "4"
},
{
"triggerid": "13824",
"description": "Zabbix discoverer processes more than 75% busy",
"priority": "3"
}
],
"id": 1
}
```
[comment]: # ({/a6701c25-8a31301f})
[comment]: # ({d9fc89e0-8005126d})
#### Преузимање одређеног окидача са ознакама
Преузми одређени окидач са ознакама.
[Захтев](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "trigger.get",
"params": {
"output": [
"triggerid",
"description"
],
"selectTags": "extend",
"triggerids": [
"17578"
]
},
"id": 1
}
```
Одговор:
```json
{
"jsonrpc": "2.0",
"result": [
{
"triggerid": "17370",
"description": "Service status",
"tags": [
{
"tag": "service",
"value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
},
{
"tag": "error",
"value": ""
}
]
}
],
"id": 1
}
```
[comment]: # ({/d9fc89e0-8005126d})
[comment]: # ({11e314dd-222d46a0})
### Види такође
- [Правило откривања](/мануал/апи/референце/дисцоверируле/објецт#дисцовери_руле)
- [Ставка](/manual/api/reference/item/object#item)
- [Домаћин](/manual/api/reference/host/object#hostт)
- [Групе домаћина](/manual/api/reference/hostgroup/object#host_group)
- [Група шаблона](/manual/api/reference/templategroup/object#template_group)
[comment]: # ({/11e314dd-222d46a0})
[comment]: # ({07515392-07515392})
### Извор
CTrigger::get() in *ui/include/classes/api/services/CTrigger.php*.
[comment]: # ({/07515392-07515392})