Documentation
Table of Contents
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
countOutputa é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
Source
CGraphItem::get() dans ui/include/classes/api/services/CGraphItem.php.