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.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro	Tipo	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` 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` con i prototipi host che hanno rilevato questo gruppo host.
selectHosts	query	Restituisce una proprietà `hosts` 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.
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`.

Valori restituiti

(integer/array) Restituisce:

un array di oggetti
il numero di oggetti recuperati, se è stato utilizzato il parametro countOutput

Esempi

Recupero dei dati per nome

Recupera tutti i dati relativi a due gruppi di host denominati "Zabbix servers" e "Linux servers".

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.get",
    "params": {
        "output": "extend",
        "filter": {
            "name": [
                "Zabbix servers",
                "Linux servers"
            ]
        }
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "groupid": "2",
            "name": "Linux servers",
            "flags": "0",
            "uuid": "dc579cd7a1a34222933f24f52a68bcd8"
        },
        {
            "groupid": "4",
            "name": "Zabbix servers",
            "flags": "0",
            "uuid": "6f6799aa69e844b4b3918f779f2abf08"
        }
    ],
    "id": 1
}

Vedi anche

Host

Sorgente

CHostGroup::get() in ui/include/classes/api/services/CHostGroup.php.

What’s next?

hostgroup.massadd

Docs

hostgroup.get

Descrizione