Table of Contents
graphitem.get
Beschrijving
integer/array graphitem.get(object parameters)
De methode maakt het mogelijk om grafiekitems op te halen volgens de gegeven parameters.
Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen, kan worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruiker rollen voor meer informatie.
Parameters
(object) Parameters die de gewenste uitvoer definiëren.
De methode ondersteunt de volgende parameters.
| Parameter | Type | Beschrijving |
|---|---|---|
| graphids | string/array | Retourneer alleen grafiekitems die bij de gegeven grafieken horen. |
| itemids | string/array | Retourneer alleen grafiekitems met de opgegeven item-ID's. |
| type | integer | Retourneer alleen grafiekitems met het opgegeven type. Raadpleeg de objectpagina voor grafiekitems voor een lijst met ondersteunde typen grafiekitems. |
| selectGraphs | query | Retourneer een eigenschap graphs met een array van grafieken waartoe het item behoort. |
| sortfield | string/array | Sorteer het resultaat op de gegeven eigenschappen. Mogelijke waarden zijn: gitemid. |
| countOutput | boolean | Deze parameters gelden voor alle get-methoden en worden in detail beschreven op de pagina referentiecommentaar. |
| editable | booleaans | |
| limiet | geheel getal | |
| uitvoer | query | |
| preservekeys | boolean | |
| sortorde | string/array |
Retourwaarden
(integer/array) Retourneert ofwel:
- een reeks objecten;
- het aantal opgehaalde objecten, als de
countOutputparameter heeft gebruikt.
Voorbeelden
Ophalen van grafiekitems uit een grafiek
Haal alle grafiekitems op die in een grafiek zijn gebruikt met aanvullende informatie over het item en de host.
Verzoek:
{
"jsonrpc": "2.0",
"method": "graphitem.get",
"params": {
"output": "extend",
"graphids": "387"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Antwoord:
{
"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": "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": "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": "Linux"
}
],
"id": 1
}Zie ook
Bron
CGraphItem::get() in ui/include/classes/api/services/CGraphItem.php.