graphitem.get

Description

integer/array graphitem.get(object parameters)

La méthode permet de récupérer des éléments de graphique en fonction des paramètres donnés.

Cette méthode est disponible pour tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir Rôles Utilisateur pour plus d'informations.

Paramètres

(object) Paramètres définissant la sortie souhaitée.

La méthode prend en charge les paramètres suivants.

Paramètre	Type	Description
graphids	string/array	Renvoie uniquement les éléments de graphique appartenant aux graphiques donnés.
itemids	string/array	Renvoie uniquement les éléments de graphique avec les ID d'élément donnés.
type	integer	Renvoie uniquement les éléments de graphique avec le type donné. Se référer à la page de l'objet Élément de graphique pour une liste des types d'élément de graphique pris en charge.
selectGraphs	query	Renvoie une propriété graphs contenant une tableau des graphiques auxquels appartient l'élément.
sortfield	string/array	Trie le résultat par les propriétés données. Les valeurs possibles sont : `gitemid`.
countOutput	boolean	Ces paramètres, communs à toutes les méthodes "get", sont décrits dans les commentaires de référence.
editable	boolean
limit	integer
output	query
preservekeys	boolean
sortorder	string/array

Valeurs retournées

(integer/array) Retourne soit :

un tableau d'objets ;
le nombre d'objets récupérés, si le paramètre countOutput a été utilisé.

Exemples

Récupération des éléments de graphiques d'un graphique donné

Récupérer tous les éléments de graphique utilisés dans un graphique avec des informations supplémentaires sur l'élément et l'hôte.

Requête :

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

Réponse :

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

Voir également

Graphique

Source

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

Documentation