[comment]: # translation:outdated [comment]: # ({cdc53a5f-cdc53a5f}) # graph.get [comment]: # ({/cdc53a5f-cdc53a5f}) [comment]: # ({b80d99e9-d2f8406d}) ### Beschreibung `integer/array graph.get(object parameters)` Mit dieser Methode können Graphen entsprechend den angegebenen Parametern abgerufen werden. ::: noteclassic Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/b80d99e9-d2f8406d}) [comment]: # ({5711b41f-5b1c5b22}) ### Parameter `(object)` Parameter, die die gewünschte Ausgabe definieren. Die Methode unterstützt die folgenden Parameter. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung| |--|--|------| |graphids|ID/array|Gibt nur Graphen mit den angegebenen IDs zurück.| |groupids|ID/array|Gibt nur Graphen zurück, die zu Hosts oder Vorlagen in den angegebenen Host-Gruppen oder Vorlagen-Gruppen gehören.| |templateids|ID/array|Gibt nur Graphen zurück, die zu den angegebenen Vorlagen gehören.| |hostids|ID/array|Gibt nur Graphen zurück, die zu den angegebenen Hosts gehören.| |itemids|ID/array|Gibt nur Graphen zurück, die die angegebenen Datenpunkte enthalten.| |templated|boolean|Wenn auf `true` gesetzt, werden nur Graphen zurückgegeben, die zu Vorlagen gehören.| |inherited|boolean|Wenn auf `true` gesetzt, werden nur Graphen zurückgegeben, die von einer Vorlage geerbt wurden.| |expandName|flag|Erweitert Makros im Graphnamen.| |selectDiscoveryData|query|Gibt eine `discoveryData`-Eigenschaft mit den Daten des Graph-Discovery-Objekts zurück. Das Graph-Discovery-Objekt verknüpft einen entdeckten Graphen mit einem Graphprototyp, aus dem er entdeckt wurde.

Es hat die folgenden Eigenschaften:
`parent_graphid` - `(ID)` ID des Graphprototyps, aus dem der Graph erstellt wurde;
`status` - `(int)` Status der Graph-Discovery:
0 - *(Standard)* Graph ist entdeckt,
1 - Graph ist nicht mehr entdeckt;
`ts_delete` - `(timestamp)` Zeitpunkt, zu dem ein Graph, der nicht mehr entdeckt wird, gelöscht wird.| |selectDiscoveryRule|query|Gibt eine [`discoveryRule`](/manual/api/reference/drule/object)-Eigenschaft mit der Low-Level-Discovery-Regel zurück, die den Graphen erstellt hat.| |selectHostGroups|query|Gibt eine [`hostgroups`](/manual/api/reference/hostgroup/object)-Eigenschaft mit den Host-Gruppen zurück, zu denen der Graph gehört.| |selectTemplateGroups|query|Gibt eine [`templategroups`](/manual/api/reference/templategroup/object)-Eigenschaft mit den Vorlagen-Gruppen zurück, zu denen der Graph gehört.| |selectTemplates|query|Gibt eine [`templates`](/manual/api/reference/template/object)-Eigenschaft mit den Vorlagen zurück, zu denen der Graph gehört.| |selectHosts|query|Gibt eine [`hosts`](/manual/api/reference/host/object)-Eigenschaft mit den Hosts zurück, zu denen der Graph gehört.| |selectItems|query|Gibt eine [`items`](/manual/api/reference/item/object)-Eigenschaft mit den im Graphen verwendeten Datenpunkten zurück.| |selectGraphItems|query|Gibt eine [`gitems`](/manual/api/reference/graphitem/object)-Eigenschaft mit den im Graphen verwendeten Datenpunkten zurück.| |filter|object|Gibt nur die Ergebnisse zurück, die exakt dem angegebenen Filter entsprechen.

Akzeptiert ein Objekt, bei dem die Schlüssel Eigenschaftsnamen sind und die Werte entweder ein einzelner Wert oder ein Array von Werten sind, mit denen abgeglichen wird.

Unterstützt keine Eigenschaften des `text`-[Datentyps](/manual/api/reference_commentary#data-types).

Unterstützt zusätzliche Eigenschaften:
`host` - technischer Name des Hosts, zu dem der Graph gehört;
`hostid` - ID des Hosts, zu dem der Graph gehört.| |sortfield|string/array|Sortiert das Ergebnis nach den angegebenen Eigenschaften.

Mögliche Werte: `graphid`, `name`, `graphtype`.| |countOutput|boolean|Diese Parameter sind in der [Referenzkommentierung](/manual/api/reference_commentary#common-get-method-parameters) beschrieben.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectGraphDiscovery|query|Gibt eine `graphDiscovery`-Eigenschaft mit dem Graph-Discovery-Objekt zurück. Die Graph-Discovery-Objekte verknüpfen den Graphen mit einem Graphprototyp, aus dem er erstellt wurde.

Diese Abfrage ist **veraltet**, bitte verwenden Sie stattdessen `selectDiscoveryData`.| [comment]: # ({/5711b41f-5b1c5b22}) [comment]: # ({7223bab1-7223bab1}) ### Rückgabewerte `(integer/array)` Kann die folgenden Dinge zurück geben: - ein Array von Objekten; - die Anzahl der abgerufenen Objekte, wenn der Parameter `countOutput` verwendet wurde. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Beispiele [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({d11e19d3-e7fae381}) #### Abrufen von Diagrammen von Hosts Rufen Sie alle Diagramme vom Host „10107“ ab und sortieren Sie sie nach Namen. [Anfrage](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graph.get", "params": { "output": "extend", "hostids": 10107, "sortfield": "name" }, "id": 1 } ``` Antwort: ```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}) ### Siehe auch - [Discovery-Regel](/manual/api/reference/discoveryrule/object#discovery-rule) - [Graph-Datenpunkt](/manual/api/reference/graphitem/object#graph-item) - [Datenpunkt](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Host-Gruppe](/manual/api/reference/hostgroup/object#host-group) - [Vorlage](/manual/api/reference/template/object#template) - [Vorlagengruppe](/manual/api/reference/templategroup/object#template-group) [comment]: # ({/7b8d40e8-e4f96e80}) [comment]: # ({6f7b2d0a-6f7b2d0a}) ### Quelle CGraph::get() in *ui/include/classes/api/services/CGraph.php*. [comment]: # ({/6f7b2d0a-6f7b2d0a})