Table of Contents
2.graphitem.get
描述
整数/数组 graphitem.get(object parameters)
此方法用于根据给定参数来获取图表监控项。
参数
(对象) 定义所需输出的参数。
此方法支持以下参数：
| 参数 类 | 描述 | |
|---|---|---|
| gitemids | string/array | 仅返回给定ID的图表监控项。 |
| graphids | string/array | 仅返回属于给定图表的图表监控项。 |
| itemids | string/array | 仅返回具有给定监控项ID的图表监控项。 |
| type | integer | 仅返回给定类型的图表监控项。 有关支持的图表监控项的类型，请参考图表监控项对象. |
| selectGraphs | query | 在 graphs(图表)属性下，以数组的形式返回监控项所属的图表。 |
| sortfield | string/array | 根据给定属性对结果进行排序。 可能值: gitemid. |
| countOutput | boolean | 以下参数为get方法通常参数，在参考注释有详细说明。 |
| editable | boolean | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| sortorder | string/array | |
返回值
(整数/数组) 返回:
- 一个数组对象;
- 如果使用了
countOutput参数，返回获取的对象的数量。
示例
从图表中获取图表监控项
获取图表中使用的所有图表监控项以及有关监控项和主机的其他信息。
请求:
{ "jsonrpc": "2.0", "method": "graphitem.get", "params": { "output": "extend", "graphids": "387" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }响应:
{ "jsonrpc": "2.0", "result": [ { "gitemid": "1242", "graphid": "387", "itemid": "22665", "drawtype": "1", "sortorder": "1", "color": "FF5555", "yaxisside": "0", "calc_fnc": "2", "type": "0", "key_": "system.cpu.util[,steal]", "hostid": "10001", "flags": "0", "host": "Template OS Linux" }, { "gitemid": "1243", "graphid": "387", "itemid": "22668", "drawtype": "1", "sortorder": "2", "color": "55FF55", "yaxisside": "0", "calc_fnc": "2", "type": "0", "key_": "system.cpu.util[,softirq]", "hostid": "10001", "flags": "0", "host": "Template OS Linux" }, { "gitemid": "1244", "graphid": "387", "itemid": "22671", "drawtype": "1", "sortorder": "3", "color": "009999", "yaxisside": "0", "calc_fnc": "2", "type": "0", "key_": "system.cpu.util[,interrupt]", "hostid": "10001", "flags": "0", "host": "Template OS Linux" } ], "id": 1 }参考
来源
CGraphItem::get() in frontends/php/include/classes/api/services/CGraphItem.php.