service.get

Опис

integer/array service.get(object parameters)

Метод омогућава преузимање услуга према датим параметрима.

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

Параметри

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

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

Parameter Type Description
serviceids ID/array Враћа само услуге са датим ID-ијевима.
parentids ID/array Враћа само услуге које су повезане са датим надређеним услугама.
deep_parentids flag Враћа све директне и индиректне подређене сервисе. Користи се заједно са parentids.
childids ID/array Враћа само услуге које су повезане са датим подређеним сервисима.
evaltype integer Правила за претрагу ознака.

Могуће вредности:
0 - (подразумевано) И/Или;
2 - Или.
tags object/array Враћа само услуге са датим ознакама. Тачно подударање по ознаци и претрага која се разликује од великих или малих слова по вредности ознаке у зависности од вредности оператора.
Формат: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Празан низ враћа све услуге.

Могуће вредности оператора:
0 - (подразумевано) Садржи;
1 – једнако;
2 – Не садржи;
3 – Није једнако;
4 – Постоји;
5 – Не постоји.
problem_tags object/array Враћа само услуге са датим ознакама проблема. Тачно подударање по ознаци и претрага која се разликује од великих или малих слова по вредности ознаке у зависности од вредности оператора.
Формат: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Празан низ враћа све услуге.

Могуће вредности оператора:
0 - (подразумевано) Садржи;
1 – Једнако;
2 – Не садржи;
3 – Није једнако;
4 – Постоји;
5 – Не постоји.
without_problem_tags flag Враћа само услуге без ознака проблема.
slaids ID/array Враћа само услуге које су повезане са одређеним SLA(s).
selectChildren query Враћа својство children са подређеним услугама.

Подржава count.
selectParents query Врати својство parents са надређеним услугама.

Подржава count.
selectTags query Веаћа tags својство са ознакама услуге.

Подржава count.
selectProblemEvents query Враћа својство problem_events са низом објеката проблематичног догађаја.

Објекат проблематичног догађаја има следећа својства:
eventid - (ID) Догађај ID;
severity - (string) Тренутна озбиљност догађаја;
name - (string) Име разрешеног догађаја.

Подржава count.
selectProblemTags query Враћа својство problem_tags са проблемом ознаке.

Подржава count.
selectStatusRules query Враћа својство status_rules са правилима статуса.

Подржава count.
selectStatusTimeline object/array Враћа својство status_timeline које садржи услугу промене стања за дате периоде.

Формат [{"period_from": "<period_from>", "period_to": "<period_to>"}, ...] - period_from је почетни датум (закључно; целобројна временска ознака) и period_to је крајњи датум (закључно; целобројна временска ознака) за период који вас занима.

Враћа низ уноса који садрже својство start_value и [alarms] (/manual/api/reference/service/object#service-alarm) низ за промене стања унутар наведених периода.
sortfield string/array Сортира резултат према датим својствима.

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

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

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

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

Примери

Преузимање свих услуга

Преузми све податке о свим услугама и њиховим зависностима.

Захтев:

{
     "jsonrpc": "2.0",
     "method": "service.get",
     "params": {
     "output": "extend",
     "selectChildren": "extend",
     "selectParents": "extend"
     },
     "id": 1
}

Одговор:

{
     "jsonrpc": "2.0",
     "result": [
     {
     "serviceid": "1",
     "name": "My Service - 0001",
     "status": "-1",
     "algorithm": "2",
     "sortorder": "0",
     "weight": "0",
     "propagation_rule": "0",
     "propagation_value": "0",
     "description": "My Service Description 0001.",
     "uuid": "dfa4daeaea754e3a95c04d6029182681",
     "created_at": "946684800",
     "readonly": false,
     "parents": [],
     "children": []
     },
     {
     "serviceid": "2",
     "name": "My Service - 0002",
     "status": "-1",
     "algorithm": "2",
     "sortorder": "0",
     "weight": "0",
     "propagation_rule": "0",
     "propagation_value": "0",
     "description": "My Service Description 0002.",
     "uuid": "20ea0d85212841219130abeaca28c065",
     "created_at": "946684800",
     "readonly": false,
     "parents": [],
     "children": []
     }
     ],
     "id": 1
}

Извор

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