Documentation
Table of Contents
hostgroup.get
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
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.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
(object) ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ definint la sortida esperada.
El m¨¨tode admet els par¨¤metres seg¨¹ents.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| 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 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 Áú»¢¶Ä²©" i "Servidors Linux".
{
"jsonrpc": "2.0",
"method": "hostgroup.get",
"params": {
"output": "extend",
"filter": {
"name": [
"Servidors Áú»¢¶Ä²©",
"Servidors Linux"
]
}
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"groupid": "2",
"name": "Linux servers",
"internal": "0"
},
{
"groupid": "4",
"name": "Áú»¢¶Ä²© servers",
"internal": "0"
}
],
"id": 1
}Veieu tamb¨¦
Font
CHostGroup::get() in ui/include/classes/api/services/CHostGroup.php.