[comment]: # translation:outdated [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]: # ({5711b41f-5b1c5b22}) ### Parametry `(object)` Parametry definiujące żądane dane wyjściowe. Metoda obsługuje następujące parametry. |Parametr|[Typ](/manual/api/reference_commentary#data-types)|Opis| |--|--|------| |graphids|ID/array|Zwracaj tylko wykresy o podanych ID.| |groupids|ID/array|Zwracaj tylko wykresy należące do hostów lub szablonów w podanych grupach hostów lub grupach szablonów.| |templateids|ID/array|Zwracaj tylko wykresy należące do podanych szablonów.| |hostids|ID/array|Zwracaj tylko wykresy należące do podanych hostów.| |itemids|ID/array|Zwracaj tylko wykresy zawierające podane pozycje.| |templated|boolean|Jeśli ustawiono `true`, zwracaj tylko wykresy należące do szablonów.| |inherited|boolean|Jeśli ustawiono `true`, zwracaj tylko wykresy odziedziczone z szablonu.| |expandName|flag|Rozwiń makra w nazwie wykresu.| |selectDiscoveryData|query|Zwróć właściwość `discoveryData` z danymi obiektu wykrywania wykresu. Obiekt wykrywania wykresu łączy wykryty wykres z prototypem wykresu, z którego został wykryty.

Ma następujące właściwości:
`parent_graphid` - `(ID)` ID prototypu wykresu, z którego wykres został utworzony;
`status` - `(int)` status wykrywania wykresu:
0 - *(domyślnie)* wykres jest wykryty,
1 - wykres nie jest już wykryty;
`ts_delete` - `(timestamp)` czas, kiedy wykres, który nie jest już wykrywany, zostanie usunięty.| |selectDiscoveryRule|query|Zwróć właściwość [`discoveryRule`](/manual/api/reference/drule/object) z regułą wykrywania niskiego poziomu, która utworzyła wykres.| |selectHostGroups|query|Zwróć właściwość [`hostgroups`](/manual/api/reference/hostgroup/object) z grupami hostów, do których należy wykres.| |selectTemplateGroups|query|Zwróć właściwość [`templategroups`](/manual/api/reference/templategroup/object) z grupami szablonów, do których należy wykres.| |selectTemplates|query|Zwróć właściwość [`templates`](/manual/api/reference/template/object) z szablonami, do których należy wykres.| |selectHosts|query|Zwróć właściwość [`hosts`](/manual/api/reference/host/object) z hostami, do których należy wykres.| |selectItems|query|Zwróć właściwość [`items`](/manual/api/reference/item/object) z pozycjami użytymi na wykresie.| |selectGraphItems|query|Zwróć właściwość [`gitems`](/manual/api/reference/graphitem/object) z pozycjami użytymi na wykresie.| |filter|object|Zwracaj tylko te wyniki, które dokładnie odpowiadają podanemu filtrowi.

Akceptuje obiekt, w którym klucze są nazwami właściwości, a wartościami są pojedyncza wartość lub tablica wartości do dopasowania.

Nie obsługuje właściwości typu 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 wykres;
`hostid` - ID hosta, do którego należy wykres.| |sortfield|string/array|Sortuj wynik według podanych właściwości.

Możliwe wartości: `graphid`, `name`, `graphtype`.| |countOutput|boolean|Te parametry opisano 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|^| |selectGraphDiscovery|query|Zwróć właściwość `graphDiscovery` z obiektem wykrywania wykresu. Obiekty wykrywania wykresu łączą wykres z prototypem wykresu, z którego został utworzony.

To zapytanie jest **przestarzałe**; użyj zamiast tego `selectDiscoveryData`.| [comment]: # ({/5711b41f-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})