[comment]: # ({cdc53a5f-cdc53a5f}) # graph.get [comment]: # ({/cdc53a5f-cdc53a5f}) [comment]: # ({b80d99e9-d2f8406d}) ### Description `integer/array graph.get(object parameters)` La méthode permet de récupérer des graphiques selon les paramètres donnés. ::: noteclassic Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d’appeler la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir [User roles](/manual/web_interface/frontend_sections/users/user_roles) pour plus d’informations. ::: [comment]: # ({/b80d99e9-d2f8406d}) [comment]: # ({32e7f0fa-5b1c5b22}) ### Paramètres `(object)` Paramètres définissant la sortie souhaitée. La méthode prend en charge les paramètres suivants. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |graphids|ID/array|Retourne uniquement les graphes avec les IDs donnés.| |groupids|ID/array|Retourne uniquement les graphes qui appartiennent à des hôtes ou des modèles dans les groupes d'hôtes ou groupes de modèles donnés.| |templateids|ID/array|Retourne uniquement les graphes qui appartiennent aux modèles donnés.| |hostids|ID/array|Retourne uniquement les graphes qui appartiennent aux hôtes donnés.| |itemids|ID/array|Retourne uniquement les graphes qui contiennent les éléments donnés.| |templated|boolean|Si défini sur `true`, retourne uniquement les graphes qui appartiennent à des modèles.| |inherited|boolean|Si défini sur `true`, retourne uniquement les graphes hérités d'un modèle.| |expandName|flag|Développe les macros dans le nom du graphe.| |selectHostGroups|query|Retourne une propriété [`hostgroups`](/manual/api/reference/hostgroup/object) avec les groupes d'hôtes auxquels le graphe appartient.| |selectTemplateGroups|query|Retourne une propriété [`templategroups`](/manual/api/reference/templategroup/object) avec les groupes de modèles auxquels le graphe appartient.| |selectTemplates|query|Retourne une propriété [`templates`](/manual/api/reference/template/object) avec les modèles auxquels le graphe appartient.| |selectHosts|query|Retourne une propriété [`hosts`](/manual/api/reference/host/object) avec les hôtes auxquels le graphe appartient.| |selectItems|query|Retourne une propriété [`items`](/manual/api/reference/item/object) avec les éléments utilisés dans le graphe.| |selectGraphDiscovery|query|Retourne une propriété `graphDiscovery` avec l'objet de découverte du graphe. Les objets de découverte du graphe lient le graphe à un prototype de graphe à partir duquel il a été créé.

Il possède les propriétés suivantes :
`graphid` - `(ID)` ID du graphe;
`parent_graphid` - `(ID)` ID du prototype de graphe à partir duquel le graphe a été créé;
`lastcheck` - `(timestamp)` heure à laquelle le graphe a été découvert pour la dernière fois;
`status` - `(int)` statut de découverte du graphe :
0 - *(par défaut)* le graphe est découvert,
1 - le graphe n'est plus découvert;
`ts_delete` - `(timestamp)` heure à laquelle un graphe qui n'est plus découvert sera supprimé.| |selectGraphItems|query|Retourne une propriété [`gitems`](/manual/api/reference/graphitem/object) avec les éléments utilisés dans le graphe.| |selectDiscoveryRule|query|Retourne une propriété [`discoveryRule`](/manual/api/reference/drule/object) avec la règle de découverte bas niveau qui a créé le graphe.| |filter|object|Retourne uniquement les résultats qui correspondent exactement au filtre donné.

Accepte un objet, où les clés sont des noms de propriétés et les valeurs sont soit une valeur unique, soit un tableau de valeurs à comparer.

Ne prend pas en charge les propriétés de type de données `text` [data type](/manual/api/reference_commentary#data-types).

Prend en charge des propriétés supplémentaires :
`host` - nom technique de l'hôte auquel le graphe appartient;
`hostid` - ID de l'hôte auquel le graphe appartient.| |sortfield|string/array|Trie le résultat selon les propriétés données.

Valeurs possibles : `graphid`, `name`, `graphtype`.| |countOutput|boolean|Ces paramètres sont décrits dans le [commentaire de référence](/manual/api/reference_commentary#common-get-method-parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectGroups
(deprecated)|query|Ce paramètre est obsolète, veuillez utiliser `selectHostGroups` ou `selectTemplateGroups` à la place.
Retourne une propriété `groups` avec les groupes d'hôtes et les groupes de modèles auxquels le graphe appartient.| [comment]: # ({/32e7f0fa-5b1c5b22}) [comment]: # ({7223bab1-7223bab1}) ### Valeurs retournées `(entier/tableau)` Renvoie soit : - un tableau d'objets ; - le nombre d'objets récupérés, si le paramètre `countOutput` a été utilisé. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Exemples [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({d11e19d3-e7fae381}) #### Récupération des graphiques des hôtes Récupérez tous les graphiques de l'hôte "10107" et triez-les par nom. [Requête](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graph.get", "params": { "output": "extend", "hostids": 10107, "sortfield": "name" }, "id": 1 } ``` Réponse : ```json { "jsonrpc": "2.0", "result": [ { "graphid": "612", "name": "CPU jumps", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "439", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "613", "name": "CPU load", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "433", "show_work_period": "1", "show_triggers": "1", "graphtype": "0", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "614", "name": "CPU utilization", "width": "900", "height": "200", "yaxismin": "0", "yaxismax": "100", "templateid": "387", "show_work_period": "1", "show_triggers": "0", "graphtype": "1", "show_legend": "1", "show_3d": "0", "percent_left": "0", "percent_right": "0", "ymin_type": "1", "ymax_type": "1", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "0" }, { "graphid": "645", "name": "Disk space usage /", "width": "600", "height": "340", "yaxismin": "0", "yaxismax": "0", "templateid": "0", "show_work_period": "0", "show_triggers": "0", "graphtype": "2", "show_legend": "1", "show_3d": "1", "percent_left": "0", "percent_right": "0", "ymin_type": "0", "ymax_type": "0", "ymin_itemid": "0", "ymax_itemid": "0", "flags": "4" } ], "id": 1 } ``` [comment]: # ({/d11e19d3-e7fae381}) [comment]: # ({7b8d40e8-e4f96e80}) ### Voir aussi - [Règle de découverte](/manual/api/reference/discoveryrule/object#discovery-rule) - [Élément de graphique](/manual/api/reference/graphitem/object#graph-item) - [Élément](/manual/api/reference/item/object#item) - [Hôte](/manual/api/reference/host/object#host) - [Groupe d'hôtes](/manual/api/reference/hostgroup/object#host-group) - [Modèle](/manual/api/reference/template/object#template) - [Groupe de modèles](/manual/api/reference/templategroup/object#template-group) [comment]: # ({/7b8d40e8-e4f96e80}) [comment]: # ({6f7b2d0a-6f7b2d0a}) ### Source CGraph::get() dans *ui/include/classes/api/services/CGraph.php*. [comment]: # ({/6f7b2d0a-6f7b2d0a})