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.