[comment]: # ({cdc53a5f-cdc53a5f}) # graph.get [comment]: # ({/cdc53a5f-cdc53a5f}) [comment]: # ({b80d99e9-d2f8406d}) ### Opis `integer/array graph.get(object parameters)` Ta metoda umożliwia pobieranie wykresów zgodnie z podanymi parametrami. ::: noteclassic Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywoływania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w [User roles](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/b80d99e9-d2f8406d}) [comment]: # ({32e7f0fa-5b1c5b22}) ### Parametry `(object)` Parametry definiujące oczekiwany wynik. Metoda obsługuje następujące parametry. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |graphids|ID/array|Zwracaj tylko grafy o podanych ID.| |groupids|ID/array|Zwracaj tylko grafy należące do hostów lub szablonów w podanych grupach hostów lub grupach szablonów.| |templateids|ID/array|Zwracaj tylko grafy należące do podanych szablonów.| |hostids|ID/array|Zwracaj tylko grafy należące do podanych hostów.| |itemids|ID/array|Zwracaj tylko grafy zawierające podane pozycje.| |templated|boolean|Jeśli ustawione na `true`, zwracaj tylko grafy należące do szablonów.| |inherited|boolean|Jeśli ustawione na `true`, zwracaj tylko grafy odziedziczone z szablonu.| |expandName|flag|Rozszerz makra w nazwie grafu.| |selectHostGroups|query|Zwróć właściwość [`hostgroups`](/manual/api/reference/hostgroup/object) z grupami hostów, do których należy graf.| |selectTemplateGroups|query|Zwróć właściwość [`templategroups`](/manual/api/reference/templategroup/object) z grupami szablonów, do których należy graf.| |selectTemplates|query|Zwróć właściwość [`templates`](/manual/api/reference/template/object) z szablonami, do których należy graf.| |selectHosts|query|Zwróć właściwość [`hosts`](/manual/api/reference/host/object) z hostami, do których należy graf.| |selectItems|query|Zwróć właściwość [`items`](/manual/api/reference/item/object) z pozycjami używanymi w grafie.| |selectGraphDiscovery|query|Zwróć właściwość `graphDiscovery` z obiektem wykrywania grafu. Obiekt wykrywania grafu łączy graf z prototypem grafu, na podstawie którego został utworzony.

Ma on następujące właściwości:
`graphid` - `(ID)` ID grafu;
`parent_graphid` - `(ID)` ID prototypu grafu, na podstawie którego został utworzony graf;
`lastcheck` - `(timestamp)` czas ostatniego wykrycia grafu;
`status` - `(int)` status wykrywania grafu:
0 - *(domyślnie)* graf został wykryty,
1 - graf nie jest już wykrywany;
`ts_delete` - `(timestamp)` czas, po którym graf, który nie jest już wykrywany, zostanie usunięty.| |selectGraphItems|query|Zwróć właściwość [`gitems`](/manual/api/reference/graphitem/object) z pozycjami używanymi w grafie.| |selectDiscoveryRule|query|Zwróć właściwość [`discoveryRule`](/manual/api/reference/drule/object) z regułą niskopoziomowego wykrywania, która utworzyła graf.| |filter|object|Zwracaj tylko te wyniki, które dokładnie pasują do podanego filtra.

Przyjmuje obiekt, w którym kluczami są nazwy właściwości, a wartościami pojedyncza wartość lub tablica wartości, z którymi ma zostać wykonane dopasowanie.

Nie obsługuje właściwości o typie danych `text` [data type](/manual/api/reference_commentary#data-types).

Obsługuje dodatkowe właściwości:
`host` - techniczna nazwa hosta, do którego należy graf;
`hostid` - ID hosta, do którego należy graf.| |sortfield|string/array|Sortuj wynik według podanych właściwości.

Możliwe wartości: `graphid`, `name`, `graphtype`.| |countOutput|boolean|Te parametry są opisane w [komentarzu referencyjnym](/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|Ten parametr jest przestarzały, użyj zamiast niego `selectHostGroups` lub `selectTemplateGroups`.
Zwróć właściwość `groups` z grupami hostów i grupami szablonów, do których należy graf.| [comment]: # ({/32e7f0fa-5b1c5b22}) [comment]: # ({7223bab1-7223bab1}) ### Zwracane wartości `(integer/array)` Zwraca: - tablicę obiektów; - liczbę pobranych obiektów, jeśli został użyty parametr `countOutput`. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Przykłady [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({d11e19d3-e7fae381}) #### Pobieranie wykresów z hostów Pobierz wszystkie wykresy z hosta „10107” i posortuj je według nazwy. [Żądanie](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graph.get", "params": { "output": "extend", "hostids": 10107, "sortfield": "name" }, "id": 1 } ``` Odpowiedź: ```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}) ### Zobacz także - [Reguła wykrywania](/manual/api/reference/discoveryrule/object#discovery-rule) - [Pozycja wykresu](/manual/api/reference/graphitem/object#graph-item) - [Pozycja](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Grupa hostów](/manual/api/reference/hostgroup/object#host-group) - [Szablon](/manual/api/reference/template/object#template) - [Grupa szablonów](/manual/api/reference/templategroup/object#template-group) [comment]: # ({/7b8d40e8-e4f96e80}) [comment]: # ({6f7b2d0a-6f7b2d0a}) ### Źródło CGraph::get() w *ui/include/classes/api/services/CGraph.php*. [comment]: # ({/6f7b2d0a-6f7b2d0a})