Documentation
Table of Contents
graph.get
Опис
integer/array graph.get(object parameters)
Метода омогућава да се добију графови према датим параметрима.
Ова метода је доступна корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Userroles за више информација.
Параметри
(object) Параметри који дефинишу жељени излаз.
Метода подржава следеће параметре.
| Parameter | Type | Опис |
|---|---|---|
| graphids | ID/array | Враћа само графиконе са датим ID-ијевима. |
| groupids | ID/array | Враћа само графиконе који припадају домаћинима или шаблонима у датим групама домаћина или групама шаблона. |
| templateids | ID/array | Враћа само графиконе који припадају датим шаблонима. |
| hostids | ID/array | Враћа само графиконе који припадају датим домаћинима. |
| itemids | ID/array | Враћа само графиконе који садрже дате ставке. |
| templated | boolean | Ако је подешено на true враћа само графиконе који припадају шаблонима. |
| inherited | boolean | Ако је подешено на true враћа само графиконе наслеђене из шаблона. |
| expandName | flag | Проширује макрое у називу графикона. |
| selectHostGroups | query | Враћа hostgroups са групама домаћина којима графикон припада. |
| selectTemplateGroups | query | Враћа својство templategroups са групама шаблона којима графикон припада. |
| selectTemplates | query | Враћа својство templates са шаблонима којима графикон припада. |
| selectHosts | query | Враћа hosts својство са домаћинима којима графикон припада. |
| selectItems | query | Враћа својство items са ставке које се користе у графу. |
| selectGraphDiscovery | query | Враћа својство graphDiscovery са објектом откривања графа. Објекти за откривање графа повезују граф са прототипом графа од којег је направљен.Има следећа својства: graphid - (ID) ID графика;parent_graphid - (ID) ID прототипа графикона од којег је графикон направљен;lastcheck - (timestamp) време када је графикон последњи пут откривен;status - ( int) статус откривања графика:0 - (подразумевано) граф је откривен, 1 - граф више није откривен; ts_delete - (timestamp) време када ће графикон који више није откривен бити избрисан. |
| selectGraphItems | query | Враћа својство gitems са ставкама које се користе у графикону. |
| selectDiscoveryRule | query | Враћа својство discoveryRule са правилом откривања ниског нивоа које је креирало графикон. |
| filter | object | Враћа само оне резултате који се тачно подударају са датим филтером. Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за подударање. Не подржава својства text data type.Подржава додатна својства: host - техничко име домаћина којем графикон припада;host - ID домаћина којем граф припада. |
| sortfield | string/array | Сортира резултат према датим својствима. Могуће вредности: graphid, name, graphtype. |
| countOutput | boolean | Ови параметрису описани у референтном коментару . |
| editable | boolean | |
| excludeSearch | boolean | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean | |
| selectGroups (застарело) |
query | Овај параметар је застарео, користите selectHostGroups или selectTemplateGroups уместо тога.Враћа својство groups са групама домаћина и групама шаблона којима графикон припада. |
Повратне вредности
(integer/array) Враћа било:
- низ објеката;
- број преузетих објеката, ако је параметар
countOutputкоришћен.
Примери
Преузимање графикона са домаћина
Преузми све графиконе са домаћина "10107" и сортирај их по имену.
{
"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
}Погледајте такође
- Discovery rule
- Graph item](/manual/api/reference/graphitem/object#graph_item)
- Item
- Host
- Host group
- Template
- Template group
Извор
CGraph::get() in ui/include/classes/api/services/CGraph.php.