[comment]: # translation:outdated [comment]: # ({cdc53a5f-cdc53a5f}) # graph.get [comment]: # ({/cdc53a5f-cdc53a5f}) [comment]: # ({b80d99e9-d2f8406d}) ### Descrizione `integer/array graph.get(object parameters)` Il metodo consente di recuperare i grafici in base ai parametri specificati. ::: noteclassic Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Vedere [User roles](/manual/web_interface/frontend_sections/users/user_roles) per ulteriori informazioni. ::: [comment]: # ({/b80d99e9-d2f8406d}) [comment]: # ({5711b41f-5b1c5b22}) ### Parametri `(object)` Parametri che definiscono l'output desiderato. Il metodo supporta i seguenti parametri. |Parametro|[Type](/manual/api/reference_commentary#data-types)|Descrizione| |--|--|------| |graphids|ID/array|Restituisce solo i grafici con gli ID specificati.| |groupids|ID/array|Restituisce solo i grafici che appartengono a host o template nei gruppi di host o gruppi di template specificati.| |templateids|ID/array|Restituisce solo i grafici che appartengono ai template specificati.| |hostids|ID/array|Restituisce solo i grafici che appartengono agli host specificati.| |itemids|ID/array|Restituisce solo i grafici che contengono gli item specificati.| |templated|boolean|Se impostato su `true`, restituisce solo i grafici che appartengono ai template.| |inherited|boolean|Se impostato su `true`, restituisce solo i grafici ereditati da un template.| |expandName|flag|Espande le macro nel nome del grafico.| |selectDiscoveryData|query|Restituisce una proprietà `discoveryData` con i dati dell'oggetto di discovery del grafico. L'oggetto di discovery del grafico collega un grafico rilevato a un prototipo di grafico da cui è stato rilevato.

Ha le seguenti proprietà:
`parent_graphid` - `(ID)` ID del prototipo di grafico da cui è stato creato il grafico;
`status` - `(int)` stato della discovery del grafico:
0 - *(predefinito)* il grafico è rilevato,
1 - il grafico non è più rilevato;
`ts_delete` - `(timestamp)` momento in cui un grafico non più rilevato verrà eliminato.| |selectDiscoveryRule|query|Restituisce una proprietà [`discoveryRule`](/manual/api/reference/drule/object) con la regola di low-level discovery che ha creato il grafico.| |selectHostGroups|query|Restituisce una proprietà [`hostgroups`](/manual/api/reference/hostgroup/object) con i gruppi di host a cui appartiene il grafico.| |selectTemplateGroups|query|Restituisce una proprietà [`templategroups`](/manual/api/reference/templategroup/object) con i gruppi di template a cui appartiene il grafico.| |selectTemplates|query|Restituisce una proprietà [`templates`](/manual/api/reference/template/object) con i template a cui appartiene il grafico.| |selectHosts|query|Restituisce una proprietà [`hosts`](/manual/api/reference/host/object) con gli host a cui appartiene il grafico.| |selectItems|query|Restituisce una proprietà [`items`](/manual/api/reference/item/object) con gli item utilizzati nel grafico.| |selectGraphItems|query|Restituisce una proprietà [`gitems`](/manual/api/reference/graphitem/object) con gli item utilizzati nel grafico.| |filter|object|Restituisce solo i risultati che corrispondono esattamente al filtro specificato.

Accetta un oggetto, in cui le chiavi sono nomi di proprietà e i valori sono un singolo valore oppure un array di valori da confrontare.

Non supporta proprietà del tipo di dati `text` [data type](/manual/api/reference_commentary#data-types).

Supporta proprietà aggiuntive:
`host` - nome tecnico dell'host a cui appartiene il grafico;
`hostid` - ID dell'host a cui appartiene il grafico.| |sortfield|string/array|Ordina il risultato in base alle proprietà specificate.

Valori possibili: `graphid`, `name`, `graphtype`.| |countOutput|boolean|Questi parametri sono descritti nel [commento di riferimento](/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|Restituisce una proprietà `graphDiscovery` con l'oggetto di discovery del grafico. Gli oggetti di discovery del grafico collegano il grafico a un prototipo di grafico da cui è stato creato.

Questa query è **deprecata**, usare invece `selectDiscoveryData`.| [comment]: # ({/5711b41f-5b1c5b22}) [comment]: # ({7223bab1-7223bab1}) ### Valori restituiti `(integer/array)` Restituisce o: - una matrice di oggetti; - il conteggio degli oggetti recuperati, se il parametro `countOutput` è stato usato. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Esempi [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({d11e19d3-e7fae381}) #### Recupero dei grafici dagli host Recupera tutti i grafici dall'host "10107" e ordinali per nome. [Richiesta](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "graph.get", "params": { "output": "extend", "hostids": 10107, "sortfield": "name" }, "id": 1 } ``` Risposta: ```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}) ### Vedi anche - [Regola di individuazione](/manual/api/reference/discoveryrule/object#discovery-rule) - [Item del grafico](/manual/api/reference/graphitem/object#graph-item) - [Item](/manual/api/reference/item/object#item) - [Host](/manual/api/reference/host/object#host) - [Gruppo di host](/manual/api/reference/hostgroup/object#host-group) - [Template](/manual/api/reference/template/object#template) - [Gruppo di template](/manual/api/reference/templategroup/object#template-group) [comment]: # ({/7b8d40e8-e4f96e80}) [comment]: # ({6f7b2d0a-6f7b2d0a}) ### Fonte CGraph::get() in *ui/include/classes/api/services/CGraph.php*. [comment]: # ({/6f7b2d0a-6f7b2d0a})