object host.update(object/array hosts)
Aquest m¨¨tode permet actualitzar els equips existents.
Aquest m¨¨tode ¨¦s disponible nom¨¦s per als usuaris de tipus Admin i Super admin. Els permisos per cridar al m¨¨tode es poden revocar a la configuraci¨® de rols d'usuaris. Per a m¨¦s informaci¨®, veieu Rols d'usuari.
(object/array)
Propietats de l'equip per actualitzar.
La propietat hostid
s'ha d'establir per a cada equip, totes les altres propietats s¨®n opcionals. Nom¨¦s s'actualitzaran les propietats indicades, les altres romandran sense canvis.
Veieu tamb¨¦ que actualitzant el nom t¨¨cnic de l'equip tamb¨¦ actualitzar¨¤ el nom visible de l'equip (si no s'ha donat o ¨¦s buit) per el valor del nom t¨¨cnic de l'equip.
A m¨¦s de les [propietats de l'objecte equip est¨¤ndard] (objecte#host), el m¨¨tode admet els par¨¤metres seg¨¹ents.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
---|---|---|
groups | object/array | Grups d'equips substituint els grups d'equips actuals als quals pertany l'equip. Els grups d'equip han de tindre la propietat groupid conjunt. Tots els grups d'equip que no s¨®n pas a la petici¨® es desenlla?aran. |
interfaces | object/array | Interf¨ªcies d'equips substituint les interf¨ªcies de l'equip actuals. S'esborraran les interf¨ªcies que no s¨®n pas a la petici¨®. |
tags | object/array | Etiquetes d'equips substituint les etiquetes d'equip actuals. S'esborraran totes etiquetes que no siguin pas a la petici¨®. |
inventory | object | Propietats de l'inventari d'equip. |
macros | object/array | Macros d'usuari que substitueixen les macros d'usuari actuals. S'esborraran les macros que no s¨®n pas a la petici¨®. |
templates | object/array | Plantilles substituint les plantilles enlla?ades actualment. Totes les plantilles que no s¨®n pas a la petici¨® es desenlla?aran. Les plantilles han de tindre la propietat templateid establerta. |
templates_clear | object/array | Templates per desenlla?ar i esborrar de l'equip. Les plantilles han de tenir la propietat templateid definida. |
A difer¨¨ncia de la interf¨ªcie de Áú»¢¶Ä²©, quan name
(nom d'equip visible) ¨¦s el mateix que host
(nom d'equip t¨¨cnic), l'actualitzaci¨® de host
mitjan?ant l'API no actualitzar¨¤ autom¨¤ticament name
. Les dues propietats s'han d'actualitzar expl¨ªcitament.
(object)
Retorna un objecte contingut als IDs dels equips actualitzats sota la propietat hostids
.
Activa el monitoratge d'un equip; ¨¦s a dir, defineix el seu estat a "0".
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10126",
"status": 0
},
"id": 1
}
Resposta:
Desenlla?ar i netejar dues plantilles de l'equip.
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10126",
"templates_clear": [
{
"templateid": "10124"
},
{
"templateid": "10125"
}
]
},
"id": 1
}
Resposta:
Reempla?a totes les macros d'equips per dues de noves.
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10126",
"macros": [
{
"macro": "{$PASS}",
"value": "password"
},
{
"macro": "{$DISC}",
"value": "sda",
"description": "Updated description"
}
]
},
"id": 1
}
Resposta:
Canvia el mode d'inventari i hi afegeix una ubicaci¨®
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10387",
"inventory_mode": 0,
"inventory": {
"location": "Latvia, Riga"
}
},
"id": 1
}
Resposta:
Reempla?a totes les etiquetes d'un equip per una de nova.
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10387",
"tags": {
"tag": "os",
"value": "rhel-7"
}
},
"id": 1
}
Resposta:
Converteix les regles de descobertes creades com a macro "autom¨¤tica" a "manual" i canvia el seu valor a "new-value".
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10387",
"macros": {
"hostmacroid": "5541",
"value": "new-value",
"automatic": "0"
}
},
"id": 1
}
Resposta:
Actualitzar l'equip "10590" per emprar el xifrat PSK nom¨¦s per a les connexions de l'equip al servidor Áú»¢¶Ä²© i canviar la identitat PSK i la clau PSK. Tingueu en compte que l'equip ha d'¨¦sser preconfigurat per emprar PSK.
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10590",
"tls_connect": 1,
"tls_accept": 2,
"tls_psk_identity": "PSK 002",
"tls_psk": "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"
},
"id": 1
}
Resposta:
CHost::update() in ui/include/classes/api/services/CHost.php.