[comment]: # translation:outdated [comment]: # ({f8d4c2e5-f8d4c2e5}) # hostgroup.get [comment]: # ({/f8d4c2e5-f8d4c2e5}) [comment]: # ({20294517-08ff22f2}) ### Descrizione `integer/array hostgroup.get(object parameters)` Questo metodo consente di recuperare i gruppi di host 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. Per ulteriori informazioni, vedere [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/20294517-08ff22f2}) [comment]: # ({5291ff51-7f042696}) ### Parametri `(object)` Parametri che definiscono l'output desiderato. Il metodo supporta i seguenti parametri. |Parametro|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione| |--|--|------| |graphids|ID/array|Restituisce solo i gruppi host che contengono host con i grafici specificati.| |groupids|ID/array|Restituisce solo i gruppi host con gli ID dei gruppi host specificati.| |hostids|ID/array|Restituisce solo i gruppi host che contengono gli host specificati.| |maintenanceids|ID/array|Restituisce solo i gruppi host interessati dalle maintenance specificate.| |triggerids|ID/array|Restituisce solo i gruppi host che contengono host con i trigger specificati.| |with\_graphs|boolean|Restituisce solo i gruppi host che contengono host con grafici.| |with\_graph\_prototypes|boolean|Restituisce solo i gruppi host che contengono host con prototipi di grafico.| |with\_hosts|boolean|Restituisce solo i gruppi host che contengono host.| |with\_httptests|boolean|Restituisce solo i gruppi host che contengono host con controlli web.

Sovrascrive il parametro `with_monitored_httptests`.| |with\_items|boolean|Restituisce solo i gruppi host che contengono host con item.

Sovrascrive i parametri `with_monitored_items` e `with_simple_graph_items`.| |with\_item\_prototypes|boolean|Restituisce solo i gruppi host che contengono host con prototipi di item.

Sovrascrive il parametro `with_simple_graph_item_prototypes`.| |with\_simple\_graph\_item\_prototypes|boolean|Restituisce solo i gruppi host che contengono host con prototipi di item abilitati per la creazione e con tipo di informazione numerico.| |with\_monitored\_httptests|boolean|Restituisce solo i gruppi host che contengono host con controlli web abilitati.| |with\_monitored\_hosts|boolean|Restituisce solo i gruppi host che contengono host monitorati.| |with\_monitored\_items|boolean|Restituisce solo i gruppi host che contengono host con item abilitati.

Sovrascrive il parametro `with_simple_graph_items`.| |with\_monitored\_triggers|boolean|Restituisce solo i gruppi host che contengono host con trigger abilitati. Anche tutti gli item utilizzati nel trigger devono essere abilitati.| |with\_simple\_graph\_items|boolean|Restituisce solo i gruppi host che contengono host con item numerici.| |with\_triggers|boolean|Restituisce solo i gruppi host che contengono host con trigger.

Sovrascrive il parametro `with_monitored_triggers`.| |selectDiscoveryRules|query|Restituisce una proprietà [`discoveryRules`](/manual/api/reference/discoveryrule/object) con le regole LLD che hanno rilevato il gruppo host.| |selectDiscoveryData|query|Restituisce una proprietà `discoveryData` con gli oggetti di discovery del gruppo host.

Ogni oggetto di discovery del gruppo host è un prototipo di gruppo host collegato al gruppo host rilevato e ha le seguenti proprietà:
`parent_group_prototypeid` - `(ID)` ID del prototipo di gruppo host da cui è stato rilevato il gruppo host;
`name` - `(string)` nome del prototipo di gruppo host;
`ts_delete` - `(timestamp)` momento in cui il gruppo host non più rilevato verrà eliminato;
`status` - `(int)` stato della discovery del gruppo host:
0 - *(predefinito)* il gruppo host è rilevato,
1 - il gruppo host non è più rilevato.| |selectHostPrototypes|query|Restituisce una proprietà [`hostPrototypes`](/manual/api/reference/hostprototypes/object) con i prototipi host che hanno rilevato questo gruppo host.| |selectHosts|query|Restituisce una proprietà [`hosts`](/manual/api/reference/host/object) con gli host che appartengono al gruppo host.

Supporta `count`.| |limitSelects|integer|Limita il numero di record restituiti dalle sotto-selezioni.

Si applica alle seguenti sotto-selezioni:
`selectHosts` - i risultati saranno ordinati per `host`.| |sortfield|string/array|Ordina il risultato in base alle proprietà specificate.

Valori possibili: `groupid`, `name`.| |countOutput|boolean|Questi parametri sono descritti nel [commento di riferimento](/manual/api/reference_commentary#common-get-method-parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectGroupDiscoveries|query|Restituisce una proprietà `groupDiscoveries` con gli oggetti di discovery del gruppo host.

Ogni oggetto di discovery del gruppo host è un prototipo di gruppo host collegato al gruppo host rilevato.

Questa query è **deprecata**, usare invece `selectDiscoveryData`.| [comment]: # ({/5291ff51-7f042696}) [comment]: # ({07ca11ca-7223bab1}) ### Valori restituiti `(integer/array)` Restituisce: - un array di oggetti - il numero di oggetti recuperati, se è stato utilizzato il parametro `countOutput` [comment]: # ({/07ca11ca-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Esempi [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({6271b06c-8ed2756a}) #### Recupero dei dati per nome Recupera tutti i dati relativi a due gruppi di host denominati "Zabbix servers" e "Linux servers". [Richiesta](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "hostgroup.get", "params": { "output": "extend", "filter": { "name": [ "Zabbix servers", "Linux servers" ] } }, "id": 1 } ``` Risposta: ```json { "jsonrpc": "2.0", "result": [ { "groupid": "2", "name": "Linux servers", "flags": "0", "uuid": "dc579cd7a1a34222933f24f52a68bcd8" }, { "groupid": "4", "name": "Zabbix servers", "flags": "0", "uuid": "6f6799aa69e844b4b3918f779f2abf08" } ], "id": 1 } ``` [comment]: # ({/6271b06c-8ed2756a}) [comment]: # ({6a994b89-e5f0abe1}) ### Vedi anche - [Host](/manual/api/reference/host/object#host) [comment]: # ({/6a994b89-e5f0abe1}) [comment]: # ({1e72ea39-1e72ea39}) ### Sorgente CHostGroup::get() in *ui/include/classes/api/services/CHostGroup.php*. [comment]: # ({/1e72ea39-1e72ea39})