[comment]: # ({cdc53a5f-cdc53a5f}) # graph.get [comment]: # ({/cdc53a5f-cdc53a5f}) [comment]: # ({b80d99e9-d2f8406d}) ### Descripció `integer/array graph.get(object parameters)` El mètode permet recuperar gràfics segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/b80d99e9-d2f8406d}) [comment]: # ({46ca7520-5b1c5b22}) ### Paramètres `(object)` Paràmetres que defineixen la sortida esperada. El mètode admet els paràmetres següents. |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |graphids|ID/array|Retorna només gràfics amb els identificadors donats.| |groupids|ID/array|Retorna només gràfics que pertanyen als equips dels grups d'equips donats.| |templateids|ID/array|Retorna només gràfics que pertanyen a les plantilles donades.| |hostids|ID/array|Retorna només gràfics que pertanyen als equips donats.| |itemids|ID/array|Retorna només gràfics que contenen els elements donats.| |templated|boolean|Si s'estableix com a `true`, retorna només gràfics amb plantilla.| |inherited|boolean|Si és `true`, retorna només els gràfics heretats d'un model.| |expandName|flag|Amplieu les macros al nom del gràfic.| |selectHostGroups|query|Retorna la propietat [`hostgroups`](/manual/api/reference/hostgroup/object) amb els grups d'equip als quals pertany el gràfic.| |selectTemplateGroups|query|Retorna la propietat [`templategroups`](/manual/api/reference/templategroup/object) amb els grups de plantilles als quals pertany el gràfic.| |selectTemplates|query|Retorna la propietat [`templates`](/manual/api/reference/template/object) amb les plantilles a les quals pertany el gràfic.| |selectHosts|query|Retorna la propietat [`hosts`](/manual/api/reference/host/object) amb els equips als quals pertany el gràfic.| |selectItems|query|Retorna la propietat [`items`](/manual/api/reference/item/object) amb els elements emprats al gràfic.| |selectGraphDiscovery|query|Retorna la propietat `graphDiscovery` que conté l'objecte de descobriment de gràfics. Els objectes de descobriment de gràfics enllacen el gràfic amb un prototip de gràfic a partir del que es va crear.

Té les propietats següents:
`graphid` - `(ID)` ID de gràfic;
`parent_graphid` - `(ID)` ID del prototip de gràfic a partir del qual es va crear el gràfic;
`lastcheck` - `(timestamp)` hora en que el gràfic es va trobar per darrer cop;
`status` - `(int)` estat de la descoberta del gràfic:
0 - *(per defecte)* el gràfic s'ha trobat,
1 - el gràfic ja no es troba;
`ts_delete` - `(timestamp)` hora en que el gràfic que no s'ha trobat s'esborrarà.| |selectGraphItems|query|Retorna la propietat [`gitems`](/manual/api/reference/graphitem/object) amb els elements emprats al gràfic.| |selectDiscoveryRule|query|Retorna la propietat [`discoveryRule`](/manual/api/reference/drule/object) amb la regla de descoberta de baix nivell que va crear el gràfic.| |filter|object|Només retorna resultats que coincideixen exactament amb el filtre donat.

Admet una matriu on les claus són noms de propietat i els valors són un valor únic o una matriu de valors per comparar.

No admet propietats de [tipus](/manual/api/reference_commentary#data-types) `text`.

Admet filtres addicionals:
`host` - nom tècnic de l'equip al qual pertany el gràfic;
`hostid` - ID de l'equip al qual pertany el gràfic.| |sortfield|string/array|Ordena el resultat per les propietats donades.

Els valors possibles són: `graphid`, `name` i `graphtype`.| |countOutput|boolean|Aquests paràmetres es descriuen a [comentaris de referència](/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
(obsolet)|query|Aquest paràmetre és obsolets; si et plau, empra `selectHostGroups` o `selectTemplateGroups`.
Retorna una propietat `groups` amb el grup d'equips i grups de plantilles a qui pertany el gràfic.| [comment]: # ({/46ca7520-5b1c5b22}) [comment]: # ({7223bab1-7223bab1}) ### Valors de retorn `(integer/array)` Retorna un d'entre: - una taula d'objectes; - el recompte d'objectes recuperats, si s'empra el paràmetre `countOutput`. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Exemples [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({d11e19d3-e7fae381}) #### Recuperar gràfics dels equips Recuperar tots els gràfics de l'equip "10107" i ordenar-los per nom. [Petició](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graph.get", "params": { "output": "extend", "hostids": 10107, "sortfield": "name" }, "id": 1 } ``` Resposta: ```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]: # ({e4f07557-e4f96e80}) ### Veieu també - [Regla de descoberta](/manual/api/reference/discoveryrule/object#discovery_rule) - [Element de gràfic](/manual/api/reference/graphitem/object#graph_item) - [Element](/manual/api/reference/item/object#item) - [Equip](/manual/api/reference/host/object#host) - [Grup d'equips](/manual/api/reference/hostgroup/object#host_group) - [Plantilla](/manual/api/reference/template/object#template) - [Grup de plantilles](/manual/api/reference/templategroup/object#template_group) [comment]: # ({/e4f07557-e4f96e80}) [comment]: # ({6f7b2d0a-6f7b2d0a}) ### Font CGraph::get() in *ui/include/classes/api/services/CGraph.php*. [comment]: # ({/6f7b2d0a-6f7b2d0a})