Documentation
Table of Contents
hostgroup.get
Descripció
integer/array hostgroup.get(object parameters)
El mètode permet recuperar grups d'equips segons els paràmetres proveïts.
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.
Paràmetres
(object) Paràmetres definint la sortida esperada.
El mètode admet els paràmetres següents.
| Paràmetre | Tipus | Descripció |
|---|---|---|
| graphids | ID/array | Retorna només grups d'equips que contenen equips o patrons amb els gràfics donats. |
| groupids | ID/array | Retorna només els grups d'equips amb els ID de grup d'equips donats. |
| hostids | ID/array | Retorna només els grups d'equips que contenen els equips donats. |
| maintenanceids | ID/array | Retorna només els grups d'equips afectats pels manteniments donats. |
| triggerids | ID/array | Retorna només grups d'equips que contenen equips o patrons amb els triggers donats. |
| with_graphs | flag | Retorna només grups d'equips que contenen equips amb gràfics. |
| with_graph_prototypes | flag | Retorna només grups d'equips que contenen equips amb prototips de gràfics. |
| with_hosts|flag | Retorna només grups d'equips que contenen equips. | |
| with_httptests | flag | Retorna només grups d'equips que contenen equips amb comprovacions web. Anul·la la configuració with_monitored_httptests. |
| with_items | flag | Retorna només grups d'equips que contenen equips o plantilles amb elements. Substitueix la configuració with_monitored_items i with_simple_graph_items. |
| with_item_prototypes | flag | Retorna només grups d'equips que contenen equips o plantilles amb prototips d'elements. Sobreescriu el paràmetre with_simple_graph_item_prototypes. |
| with_simple_graph_item_prototypes | marcador | Retorna només grups d'equips que contenen equips amb prototips d'elements, activats en crear-los i amb informació de tipus numèric. |
| with_monitored_httptests | flag | Retorna només grups d'equips que contenen equips amb monitors web activats. |
| with_monitored_hosts | flag | Retorna només grups d'equips que contenen equips monitorats. |
| with_monitored_items | flag | Retorna només grups d'equips que contenen equips o plantilles amb elements activats. Sobreescriu la configuració with_simple_graph_items. |
| with_monitored_triggers | flag | Retorna només grups d'equips que contenen equips amb triggers activats. També s'han d'activar tots els elements emprats al trigger. |
| with_simple_graph_items | flag | Retorna només grups d'equips que contenen equips amb elements numèrics. |
| with_triggers | flag | Retorna només grups d'equips que contenen equips amb triggers. Sobreescriu la configuració with_monitored_triggers. |
| selectDiscoveryRules | query | Retorna una propietat discoveryRules que conté la regla de descobriment de baix nivell que va crear el grup d'equips. |
| selectGroupDiscoveries | query | Retorna la propietat groupDiscoveries que conté l'objecte de descoberta del grup d'equips.L'objecte de descoberta del grup d'equips enllaça un grup d'equips descobert a un grup d'equips prototip i té les propietats següents: parent_group_prototypeid - (ID) ID del prototip del grup d'equips a partir del qual es va crear l'equip;name - (string) nom del prototip del grup d'equips;lastcheck - (timestamp) moment en que es ba trobar el darrer grup d'equips;groupid - (cadena) identificador del grup d'equips descobert;lastcheck - (timestamp) moment en que es ba trobar el darrer grup d'equips;ts_delete' -(timestamp)hora en què un grup d'equips que ja no es descobreix s'esborrarà;status-(int)estat de la descoberta del grup d'equips:hostPrototypes](/manual/api/reference/hostprototypes/object) que conté els prototipus d'equips que ha trobat aquest grup d'equips.| |selectHosts|query|Retorna una propietat [hosts](/manual/api/reference/host/object) que conté els equips que pertanyen al grup d'equips.count.| |limitSelects|integer|Limita el nombre de registres retornats per les subconsultes.selectHosts- els resultats s'ordenaran perhost.| |sortfield|string/array|Ordena el resultat per les propietats donades.groupid,name.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodesget, es descriuen als [comentaris de referència](/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|^| |monitored\_hosts(obsolet)|flag|Aquest paràmetre és obsolet; empreuwith_monitored_hostsen el seu lloc.with_hosts` en el seu lloc.Retorna només grups d'equips que contenen equips. |
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.
Exemples
recupear informació per nom
Recupera tota la informació dels grups d'equips anomenats "Servidors Zabbix" i "Servidors Linux".
{
"jsonrpc": "2.0",
"method": "hostgroup.get",
"params": {
"output": "extend",
"filter": {
"name": [
"Servidors Zabbix",
"Servidors Linux"
]
}
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"groupid": "2",
"name": "Linux servers",
"internal": "0"
},
{
"groupid": "4",
"name": "Zabbix servers",
"internal": "0"
}
],
"id": 1
}Veieu també
Font
CHostGroup::get() in ui/include/classes/api/services/CHostGroup.php.