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 >", "вредност": "< value >", " оператор": "< operator >"}, ...].
Празан низ враћа све услуге.

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

Могуће вредности оператора:
0 - (подразумевано) Садржи;
1 – једнако;
2 – не садржи;
3 – није једнако;
4 – постоји;
5 – не постоји.| |without_problem_tags|flag|Врати само услуге без ознака проблема.| |slaids|ID/array|Врати само услуге које су повезане са одређеним SLA.| |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_to >"}, ...] - период_фром је почетни датум (укључиво; целобројна временска ознака) и период до је крајњи датум (искључиво; целобројна временска ознака) за период који вас занима.

Враћа низ уноса који садрже својство start_value и [alarms] (/manual/api/reference/service/object#service-alarm) низ за промене стања унутар наведеног периоде.| |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.