[comment]: # translation:outdated [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]: # ({5711b41f-5b1c5b22}) ### Paramètres `(object)` Paramètres définissant la sortie souhaitée. La méthode prend en charge les paramètres suivants. |Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |graphids|ID/array|Retourner uniquement les graphiques avec les ID donnés.| |groupids|ID/array|Retourner uniquement les graphiques qui appartiennent aux hôtes ou aux modèles des groupes d'hôtes ou groupes de modèles donnés.| |templateids|ID/array|Retourner uniquement les graphiques qui appartiennent aux modèles donnés.| |hostids|ID/array|Retourner uniquement les graphiques qui appartiennent aux hôtes donnés.| |itemids|ID/array|Retourner uniquement les graphiques qui contiennent les éléments donnés.| |templated|boolean|Si défini sur `true`, retourner uniquement les graphiques qui appartiennent à des modèles.| |inherited|boolean|Si défini sur `true`, retourner uniquement les graphiques hérités d'un modèle.| |expandName|flag|Développer les macros dans le nom du graphique.| |selectDiscoveryData|query|Retourner une propriété `discoveryData` avec les données de l'objet de découverte du graphique. L'objet de découverte du graphique relie un graphique découvert à un prototype de graphique à partir duquel il a été découvert.

Il possède les propriétés suivantes :
`parent_graphid` - `(ID)` ID du prototype de graphique à partir duquel le graphique a été créé ;
`status` - `(int)` état de découverte du graphique :
0 - *(par défaut)* le graphique est découvert,
1 - le graphique n'est plus découvert ;
`ts_delete` - `(timestamp)` heure à laquelle un graphique qui n'est plus découvert sera supprimé.| |selectDiscoveryRule|query|Retourner une propriété [`discoveryRule`](/manual/api/reference/drule/object) avec la règle de découverte de bas niveau qui a créé le graphique.| |selectHostGroups|query|Retourner une propriété [`hostgroups`](/manual/api/reference/hostgroup/object) avec les groupes d'hôtes auxquels le graphique appartient.| |selectTemplateGroups|query|Retourner une propriété [`templategroups`](/manual/api/reference/templategroup/object) avec les groupes de modèles auxquels le graphique appartient.| |selectTemplates|query|Retourner une propriété [`templates`](/manual/api/reference/template/object) avec les modèles auxquels le graphique appartient.| |selectHosts|query|Retourner une propriété [`hosts`](/manual/api/reference/host/object) avec les hôtes auxquels le graphique appartient.| |selectItems|query|Retourner une propriété [`items`](/manual/api/reference/item/object) avec les éléments utilisés dans le graphique.| |selectGraphItems|query|Retourner une propriété [`gitems`](/manual/api/reference/graphitem/object) avec les éléments utilisés dans le graphique.| |filter|object|Retourner uniquement les résultats qui correspondent exactement au filtre donné.

Accepte un objet, où les clés sont des noms de propriété 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 graphique appartient ;
`hostid` - ID de l'hôte auquel le graphique appartient.| |sortfield|string/array|Trier 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|^| |selectGraphDiscovery|query|Retourner une propriété `graphDiscovery` avec l'objet de découverte du graphique. Les objets de découverte du graphique relient le graphique à un prototype de graphique à partir duquel il a été créé.

Cette requête est **obsolète**, veuillez utiliser `selectDiscoveryData` à la place.| [comment]: # ({/5711b41f-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})