Documentation
Table of Contents
- host.get
- ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
- ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
- Valors de retorn
- Exemples
- Recuperar informaci¨® per nom
- Recuperar els grups d'equips
- Recuperar les plantilles enlla?ades
- Recuperar equips per plantilla
- Cerca d'equip per les dades de l'inventari
- Cerca per etiquetes d'equip
- Cerca d'equips amb les etiquetes i les etiquetes de les plantilles
- Cerca d'equips per gravetat del problema
- Veieu tamb¨¦
- Font
host.get
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
integer/array host.get(object parameters)
El m¨¨tode permet recuperar 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) ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ definit la sortida esperada.
El m¨¨tode admet els par¨¤metres seg¨¹ents.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| groupids | ID/array | Retorna nom¨¦s els equips que pertanyen als grups donats. |
| dserviceids | ID/array | Retorna nom¨¦s els equips associats amb els serveis descoberts donats. |
| graphids | ID/array | Retorna nom¨¦s els equips que tenen els gr¨¤fics indicats. |
| hostids | ID/array | Retorna nom¨¦s els equips amb els ID d'equip donats. |
| httptestids | ID/array | Retorna nom¨¦s els equips amb els monitors web indicats. |
| interfaceids | ID/array | Retorna nom¨¦s els equips que empren les interf¨ªcies donades. |
| itemids | ID/array | Retorna nom¨¦s els equips amb els elements donats. |
| maintenanceids | ID/array | Retorna nom¨¦s els equips afectats pels manteniments donats. |
| monitored_hosts | flag | Retorna nom¨¦s els equips monitorats. |
| proxyids | ID/array | Retorna nom¨¦s els equips monitorats pels proxys donats. |
| proxy_groupids | ID/array | Retorna nom¨¦s els equips que s¨®n monitorats per els grups de proxys donats. |
| templated_hosts | flag | Retorna tant equips com plantilles. |
| templateids | ID/array | Retorna nom¨¦s els equips vinculats a les plantilles donades. |
| triggerids | ID/array | Retorna nom¨¦s els equips amb els triggers donats. |
| with_items | flag | Retorna nom¨¦s els equips que tenen elements. Substitueix els par¨¤metres with_monitored_items i with_simple_graph_items. |
| with_item_prototypes | flag | Retorna nom¨¦s els equips que tenen prototipus d'elements. Sobreescriu el par¨¤metre with_simple_graph_item_prototypes. |
| with_simple_graph_item_prototypes | flag | Retorna nom¨¦s els equips que tenen prototipus d'elements, s¨®n habilitats per a la creaci¨® i tenen informaci¨® de tipus num¨¨ric. |
| with_graph | flag | Retorna nom¨¦s equips amb gr¨¤fics. |
| with_graph_prototypes | flag | Retorna nom¨¦s els equips amb prototips de gr¨¤fics. |
| with_httptests | flag | Retorna nom¨¦s equips amb monitoratge web. Sobreescriu el par¨¤metre with_monitored_httptests. |
| with_monitored_httptests | flag | Retorna nom¨¦s equips amb monitors web actius. |
| with_monitored_items | flag | Retorna nom¨¦s els equips amb elements actius. Anul¡¤la la configuraci¨® with_simple_graph_items. |
| with_monitored_triggers | flag | Retorna nom¨¦s els equips amb triggers actius. Tamb¨¦ s'han d'activar tots els elements emprats al trigger. |
| with_simple_graph_items | flag | Retorna nom¨¦s els equips amb elements que contenen informaci¨® de tipus num¨¨ric. |
| with_triggers | flag | Retorna nom¨¦s els equips amb triggers. Anul¡¤la la configuraci¨® with_monitored_triggers. |
| withProblemsSuppressed | boolean | Retorna els equips amb problemes esborrats. Valors possibles: null - (per defecte) tots els equips;true - nom¨¦s els equips amb problemes eborrats;<br >false - nom¨¦s els equips amb problemes no esborrats. |
| evaltype | integer | Regles de cerca d'etiquetes. Valors possibles: 0 - (per defecte) i/o; 2 - O. |
| severities | integer/array | Retorna els equips que nom¨¦s tenen problemes amb una gravetat determinada. S'aplica nom¨¦s si l'objecte problem¨¤tic ¨¦s un trigger. |
| tags | object/array | Retorna nom¨¦s els equips amb etiquetes donades. Concordan?a exacta per etiqueta i cerca entre maj¨²scules i min¨²scules o no per valor d'etiqueta en funci¨® del valor de l'operador. Format: [{"tag": "<etiqueta>", "value": "< valor>", "operator": "<operador>"}, ...].Una matriu buida retorna tots els equips. Possibles valors d'operador: 0 - (per defecte) Cont¨¦; 1 - ?s igual; 2 - No ¨¦s com; 3 - No ¨¦s igual 4 - Existeix; 5 - No existeix. |
| inheritedTags | boolean | Retorna els equips que tenen etiquetes donades aix¨ª com en totes les seves plantilles enlla?ades. Valors per defecte:Possibles valors: true - els models enlla?ats tamb¨¦ han de tenir les etiquetes;false - (per defecte) les etiquetes de models enlla?ats s'ignoren. |
| selectDiscoveries | query | Retorna una propietat discoveries que cont¨¦ regles de descoberta de baix nivell.Admet count. |
| selectDiscoveryRule | query | Retorna una propietat discoveryRule amb la regla de descoberta de baix nivell que va crear l'equip (a partir del prototip d'equip al monitoratge de VMware). |
| selectGraphs | query | Retorna una propietat graphs amb gr¨¤fics de l'equip.Admet count. |
| selectHostDiscovery | query | Retorna una propietat hostDiscovery amb dades de l'objecte de descoberta de l'equip.L'objecte de descoberta de l'equip enlla?a un equip descobert a un prototip o un prototip d'equips a una regla de descoberta de baix nivell i t¨¦ les propietats seg¨¹ents: host - (string) equip de l'equip prototip;hostid - (string) Id de l'equip descobert o equip prototip;parent_hostid - (string) ID del prototip d'equip a partir del qual es va crear l'equip;parent_itemid - (string) ID de la regla de descoberta de baix nivell que va crear l'equip descobert;lastcheck - (timestamp) hora en qu¨¨ es va trobar l'equip per darrer cop;status - (int) estat de la descoberta de l'equip:0 - (per defecte) l'euqip s'ha trobat, 1 - l'equip ja no es troba; ts_delete - (timestamp) hora en qu¨¨ s'eliminar¨¤ un equip que ja no es descobreix;ts_disable - (timestamp) hora quan l'equip que ja no es troba es desactivar¨¤;disable_source - (int) indicador sobre si l'equip s'ha deshabilitat per una regla LLD o manualment:0 - (per defecte) desactivat autom¨¤ticament, 1 - desactivat per una regla LLD. |
| selectHostGroups | query | Retorna una propietat hostgrups amb els grups d'equip als quals pertany l'equip. |
| selectHttpTests | query | Retorna una propietat httpTests amb escenaris web d'equip.Admet count. |
| selectInterfaces | query | Retorna una propietat interfaces amb interf¨ªcies d'equip.Admet count. |
| selectInventory | query | Retorna una propietat inventory amb dades d'inventari de l'equip. |
| selectItems | query | Retorna una propietat items amb elements de l'equip.Admet count. |
| selectMacros | query | Retorna una propietat de macros amb macros de l'equip. |
| selectParentTemplates | query | Retorna una propietat parentTemplates amb les plantilles a les quals est¨¤ vinculat l'equip.A m¨¦s dels camps de l'objecte de la plantilla, tamb¨¦ cont¨¦ link_type - (integer) de quina manera la plantilla s'ha enlla?at a l'equip.Valors possibles: 0 - (per defecte) enlla?ada manualment; 1 - enlla?ada autom¨¤ticament per una regla LLD. Admet count. |
| selectDashboards | query | Retorna una propietat dashboards.Admet count. |
| selectTags | query | Retorna una propietat tags amb totes les etiquetes d'equip. |
| selectInheritedTags | query | Retorna una propietat inheritedTags amb les etiquetes que es troben a tots els models vinculats a l'equip. |
| selectTriggers | query | Retorna una propietat triggers amb triggers de l'equip.Admet count. |
| selectValueMaps | query | Retorna una propietat valuemaps amb mapes de valors de l'equip. |
| filter | object | Nom¨¦s retorna resultats que coincideixen exactament amb el filtre donat. Accepta un objecte, on les claus s¨®n noms de propietat i els valors s¨®n un valor ¨²nic o una matriu de valors per comparar. No admet propietats del tipus d'informaci¨® text.Admet propietats addicionals: propietats d'interf¨ªcie d'equip. |
| limitSelects | integer | Limita el nombre de registres retornats per subconsultes. S'aplica a les subconsultes seg¨¹ents: selectParentTemplates - els resultats s'ordenaran per host;selectInterfaces;selectItems - ordenat per name;selectDiscoveries - ordenat per name;selectTriggers - ordenat per description;selectGraphs - ordenat per name;selectDashboards - ordenat per name. |
| search | object | Retorna resultats que coincideixen amb la cerca gen¨¨rica donada (sensible a maj¨²scules i min¨²scules). Admet un objecte, on les claus s¨®n noms de propietat i els valors s¨®n cadenes per cercar. Si no es donen opcions addicionals, es far¨¤ una cerca de tipus LIKE "%...%".Nom¨¦s permet les propietats de tipus de dades string i text.Admet propietats addicionals: propietats d'interf¨ªcie d'equip. |
| searchInventory | object | Retorna nom¨¦s els equips les dades d'inventari dels quals coincideixen amb el patr¨® donat (sensible a maj¨²scules i min¨²scules). Admet un objecte, on les claus s¨®n noms de propietat i els valors s¨®n cadenes per cercar. Si no es donen opcions addicionals, es far¨¤ una cerca de tipus LIKE "%...%".Nom¨¦s permet les propietats de tipus de dades string i text. |
| sortfield | string/array | Ordena el resultat segons les propietats donades. Valors possibles: hostid, host, name, status. |
| countOutput | boolean | Aquests par¨¤metres es descriuen als comentaris de refer¨¨ncia. |
| editable | boolean | |
| excludeSearch | boolean | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean | |
| selectGroups (obsolet) |
query | Aquest par¨¤metre ¨¦s obsolet; si et plau, empra selectHostGroups en el seu lloc.Retorna la propietat groups amb informaci¨® dels grups d'equips on pertany l'equip. |
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
Recuperar informaci¨® per nom
Recuperar tota la informaci¨® de dos equips anomenats "Servidor Áú»¢¶Ä²© " i "Servidor Linux".
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"filter": {
"host": [
"Servidor Áú»¢¶Ä²©",
"Servidor Linux"
]
}
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "10160",
"proxyid": "0",
"host": "Servidor Áú»¢¶Ä²©",
"status": "0",
"ipmi_authtype": "-1",
"ipmi_privilege": "2",
"ipmi_username": "",
"ipmi_password": "",
"maintenanceid": "0",
"maintenance_status": "0",
"maintenance_type": "0",
"maintenance_from": "0",
"name": "Servidor Áú»¢¶Ä²©",
"flags": "0",
"description": "El servidor de monitoritzaci¨® Áú»¢¶Ä²©.",
"tls_connect": "1",
"tls_accept": "1",
"tls_issuer": "",
"tls_subject": "",
"proxy_groupid": "0",
"monitored_by": "0",
"inventory_mode": "1",
"active_available": "1",
"assigned_proxyid": "0"
},
{
"hostid": "10167",
"proxyid": "0",
"host": "Linux server",
"status": "0",
"ipmi_authtype": "-1",
"ipmi_privilege": "2",
"ipmi_username": "",
"ipmi_password": "",
"maintenanceid": "0",
"maintenance_status": "0",
"maintenance_type": "0",
"maintenance_from": "0",
"name": "Linux server",
"flags": "0",
"description": "",
"tls_connect": "1",
"tls_accept": "1",
"tls_issuer": "",
"tls_subject": "",
"proxy_groupid": "0",
"monitored_by": "0",
"inventory_mode": "1",
"active_available": "1",
"assigned_proxyid": "0"
}
],
"id": 1
}Recuperar els grups d'equips
Recupera els noms dels grups on l'equip "Servidor Áú»¢¶Ä²©" n'¨¦s membre.
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": ["hostid"],
"selectHostGroups": "extend",
"filter": {
"host": [
"Servidor Áú»¢¶Ä²©"
]
}
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "10085",
"hostgroups": [
{
"groupid": "2",
"name": "Linux servers",
"flags": "0",
"uuid": "dc579cd7a1a34222933f24f52a68bcd8"
},
{
"groupid": "4",
"name": "Áú»¢¶Ä²© servers",
"flags": "0",
"uuid": "6f6799aa69e844b4b3918f779f2abf08"
}
]
}
],
"id": 1
}Recuperar les plantilles enlla?ades
Recupera l'ID i els noms de les plantilles enlla?ades a l'equip "10084".
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": ["hostid"],
"selectParentTemplates": [
"templateid",
"name"
],
"hostids": "10084"
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "10084",
"parentTemplates": [
{
"name": "Linux",
"templateid": "10001"
},
{
"name": "Áú»¢¶Ä²© Server",
"templateid": "10047"
}
]
}
],
"id": 1
}Recuperar equips per plantilla
Recupera els equips que tenen la plantilla "10001" (Linux amb agent Áú»¢¶Ä²©) enlla?ada.
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": ["hostid", "name"],
"templateids": "10001"
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"templateid": "10001",
"hosts": [
{
"hostid": "10084",
"name": "Áú»¢¶Ä²© server"
},
{
"hostid": "10603",
"name": "Host 1"
},
{
"hostid": "10604",
"name": "Host 2"
}
]
}
],
"id": 1
}Cerca d'equip per les dades de l'inventari
Cerca els equips que contenen "Linux" al camp OS" de l'inventari.
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": [
"host"
],
"selectInventory": [
"os"
],
"searchInventory": {
"os": "Linux"
}
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "10084",
"host": "Áú»¢¶Ä²© server",
"inventory": {
"os": "Linux Ubuntu"
}
},
{
"hostid": "10107",
"host": "Linux server",
"inventory": {
"os": "Linux Mint"
}
}
],
"id": 1
}Cerca per etiquetes d'equip
Recupera els equips que tenen "linux-server" com a etiqueta de "host-name".
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": ["hostid"],
"selectTags": "extend",
"evaltype": 0,
"tags": [
{
"tag": "host-name",
"value": "linux-server",
"operator": 1
}
]
},
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "10085",
"tags": [
{
"tag": "host-name",
"value": "linux-server",
"automatic": "0"
},
{
"tag": "os",
"value": "rhel-7",
"automatic": "0"
}
]
}
],
"id": 1
}Retrieve hosts that have these tags not only on host level but also in their linked parent templates.
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": ["name"],
"tags": [
{
"tag": "os",
"value": "rhel-7",
"operator": 1
}
],
"inheritedTags": true
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "10623",
"name": "PC room 1"
},
{
"hostid": "10601",
"name": "Office"
}
],
"id": 1
}Cerca d'equips amb les etiquetes i les etiquetes de les plantilles
Cerca un equip amb les etiquetes i totes les etiquetes enlla?ades a les plantilles mare.
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": ["name"],
"hostids": 10502,
"selectTags": ["tag", "value"],
"selectInheritedTags": ["tag", "value"]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "10502",
"name": "Desktop",
"tags": [
{
"tag": "host-name",
"value": "linux-server"
},
{
"tag": "os",
"value": "rhel-7"
}
],
"inheritedTags": [
{
"tag": "class",
"value": "os"
},
{
"tag": "target",
"value": "linux"
},
{
"tag": "os",
"value": "rhel-7"
}
]
}
],
"id": 1
}Cerca d'equips per gravetat del problema
Cerca els equips que tenen problemes amb gravetat "Desastre".
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": ["name"],
"severities": 5
},
"id": 1
}Resposta:
Recupera els equips que tenen com gravetat "Mitjana" i "Alta".
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": ["name"],
"severities": [3, 4]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"hostid": "20170",
"name": "Database"
},
{
"hostid": "20183",
"name": "workstation"
}
],
"id": 1
}Veieu tamb¨¦
Font
CHost::get() in ui/include/classes/api/services/CHost.php.