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	Geef alleen grafiek-items terug die behoren tot de opgegeven grafieken.
itemids	string/array	Geef alleen grafiek-items terug met de opgegeven item-ID's.
type	integer	Geef alleen grafiek-items terug met het opgegeven type. Zie de pagina van het grafiek-itemobject voor een lijst van ondersteunde grafiek-itemtypes.
selectGraphs	query	Geef een eigenschap graphs terug met een reeks grafieken waartoe het item behoort.
sortfield	string/array	Sorteer het resultaat op de opgegeven eigenschappen. Mogelijke waarden: `gitemid`.
countOutput	boolean	Deze parameters, die gemeenschappelijk zijn voor alle `get`-methoden, worden in detail beschreven op de pagina referentiecommentaar.
editable	boolean
limit	integer
output	query
preservekeys	boolean
sortorder	string/array

Retourwaarden

(integer/array) Retourneert ofwel:

een reeks objecten;
het aantal opgehaalde objecten, als de countOutput parameter heeft gebruikt.

Voorbeelden

Grafiekitems ophalen uit een grafiek

Haal alle grafiekitems op die in een grafiek worden gebruikt, met aanvullende informatie over het item en de host.

Aanvraag:

{
           "jsonrpc": "2.0",
           "method": "graphitem.get",
           "params": {
               "output": "extend",
               "graphids": "387"
           },
           "id": 1
       }

Reactie:

{
           "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

Grafiek

Bron

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

Documentation