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 за промене стања унутар наведених периода.
sortfield string/array Сортира резултат према датим својствима.

Могуће вредности: serviceid, name, status, sortorder, created_at.
countOutput boolean Ови параметри који су заједнички за све get методе су детаљно описани у референтном коментару.
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.