graph.get

Опис

integer/array graph.get(object parameters)

Метода омогућава да се добију графови према датим параметрима.

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

Параметри

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

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

Parameter Type Description
graphids ID/array Врати само графиконе са датим ID-ијевима.
groupids ID/array Врати само графиконе који припадају домаћинима или шаблонима у датим групама домаћина или групама шаблона.
templateids ID/array Врати само графиконе који припадају датим шаблонима.
hostids ID/array Врати само графиконе који припадају датим домаћинима.
itemids ID/array Врати само графиконе који садрже дате ставке.
templated boolean Ако је подешено на true, врати само графиконе који припадају шаблонима.
inherited boolean Ако је подешено на true, врати само графиконе наслеђене из шаблона.
expandName flag Прошири макрое у називу графа.
selectDiscoveryData query Враћа својство discoveryData са подацима објекта за откривање графа. Објекат за откривање графа повезује откривени граф са прототипом графа из којег је откривен.

Има следећа својства:
parent_graphid - (ID) ID прототипа графа из којег је граф креиран;
lastcheck - (timestamp) време када је граф последњи пут откривен;
status - (int) статус откривања графа:
0 - (подразумевано) граф је откривен,
1 - граф више није откривен;
ts_delete - (timestamp) време када ће граф који више није откривен бити обрисан.
selectDiscoveryRule query Врати својство discoveryRule са правилом откривања ниског нивоа које је креирало граф.
selectDiscoveryRulePrototype query Врати својство discoveryRulePrototype са родитељским прототипом LLD правила који је креирао граф.
selectHostGroups query Врати својство hostgroups са групама хостова којима граф припада.
selectTemplateGroups query Врати својство templategroups са групама шаблона којима граф припада.
selectTemplates query Врати својство templates са шаблонима којима граф припада.
selectHosts query Врати својство hosts са хостовима којима граф припада.
selectItems query Врати својство items са ставкама коришћеним у графу.
selectGraphDiscovery query Врати својство graphDiscovery са објектом за откривање графа. Објекти за откривање графа повезују граф са прототипом графа од ког је креиран.

Овај упит је застарео, уместо њега користите selectDiscoveryData.
selectGraphItems query Враћа својство gitems са ставкама коришћеним у графикону.
filter object Враћа само оне резултате који се тачно подударају са датим филтером.

Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за упоређивање.

Не подржава својства text тип података.

Подржава додатна својства:
host - технички назив домаћина којем графикон припада;
hostid - ID домаћина којем графикон припада.
sortfield string/array Сортира резултат по датим својствима.

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

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

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

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

Примери

Преузимање графикона са домаћина

Преузми све графиконе са домаћина "10107" и сортирај их по имену.

Request:

{
            "jsonrpc": "2.0",
            "method": "graph.get",
            "params": {
            "output": "extend",
            "hostids": 10107,
            "sortfield": "name"
            },
            "id": 1
       }

Одговор:

{
            "jsonrpc": "2.0",
            "result": [
            {
            "graphid": "612",
            "name": "CPU jumps",
            "width": "900",
            "height": "200",
            "yaxismin": "0",
            "yaxismax": "100",
            "templateid": "439",
            "show_work_period": "1",
            "show_triggers": "1",
            "graphtype": "0",
            "show_legend": "1",
            "show_3d": "0",
            "percent_left": "0",
            "percent_right": "0",
            "ymin_type": "0",
            "ymax_type": "0",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "flags": "0"
            },
            {
            "graphid": "613",
            "name": "CPU load",
            "width": "900",
            "height": "200",
            "yaxismin": "0",
            "yaxismax": "100",
            "templateid": "433",
            "show_work_period": "1",
            "show_triggers": "1",
            "graphtype": "0",
            "show_legend": "1",
            "show_3d": "0",
            "percent_left": "0",
            "percent_right": "0",
            "ymin_type": "1",
            "ymax_type": "0",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "flags": "0"
            },
            {
            "graphid": "614",
            "name": "CPU utilization",
            "width": "900",
            "height": "200",
            "yaxismin": "0",
            "yaxismax": "100",
            "templateid": "387",
            "show_work_period": "1",
            "show_triggers": "0",
            "graphtype": "1",
            "show_legend": "1",
            "show_3d": "0",
            "percent_left": "0",
            "percent_right": "0",
            "ymin_type": "1",
            "ymax_type": "1",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "flags": "0"
            },
            {
            "graphid": "645",
            "name": "Disk space usage /",
            "width": "600",
            "height": "340",
            "yaxismin": "0",
            "yaxismax": "0",
            "templateid": "0",
            "show_work_period": "0",
            "show_triggers": "0",
            "graphtype": "2",
            "show_legend": "1",
            "show_3d": "1",
            "percent_left": "0",
            "percent_right": "0",
            "ymin_type": "0",
            "ymax_type": "0",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "flags": "4"
            }
            ],
            "id": 1
       }

Погледајте такође

Извор

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