object host.update(object/array hosts)
Este m¨¦todo permite actualizar los equipos existentes.
Este m¨¦todo solo est¨¢ disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para llamar al m¨¦todo se pueden revocar en la configuraci¨®n del rol de usuario. Ver Roles de usuario para m¨¢s informaci¨®n.
(objeto/matriz)
Propiedades del equipo que se actualizar¨¢n.
La propiedad hostid
debe definirse para cada equipo, todas las dem¨¢s propiedades son opcionales. S¨®lo se actualizar¨¢n las propiedades dadas, todas las otras permanecer¨¢n sin cambios.
Sin embargo, tenga en cuenta que al actualizar el nombre t¨¦cnico del equipo tambi¨¦n se actualizar¨¢ el nombre visible del equipo (si no est¨¢ dado o est¨¢ vac¨ªo) por el valor del nombre t¨¦cnico del equipo.
Adem¨¢s de las propiedades est¨¢ndar del equipo, el m¨¦todo acepta los siguientes par¨¢metros.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
---|---|---|
groups | objeto/matriz | Grupos de equipos para reemplazar los grupos de equipos actuales a los que pertenece el equipo. Los grupos de equipos deben tener el groupid propiedad definida. Todos los grupos de equipos que no figuran en la solicitud se desvincular¨¢n. |
interfaces | objeto/matriz | Host interfaces para reemplazar las interfaces de equipo actuales. Se eliminar¨¢n todas las interfaces que no figuran en la solicitud. |
tags | objeto/matriz | etiquetas de equipo, para reemplazar las etiquetas de equipo actuales. Se eliminar¨¢n todas las etiquetas que no aparezcan en la solicitud . |
inventory | objeto | Propiedades del inventario del equipo. |
macros | objeto/matriz | Macros de usuario para reemplazar las macros de usuario actuales. Se eliminar¨¢n todas las macros que no figuran en la solicitud. |
templates | objeto/matriz | Plantillas para reemplazar las plantillas actualmente vinculadas. Todas las plantillas que no figuran en la solicitud solo se desvincular¨¢n. Las plantillas deben tener definida la propiedad templateid . |
templates_clear | objeto/matriz | Plantillas para desvincular y borrar del equipo. Las plantillas deben tener definida la propiedad templateid . |
A diferencia de la interfaz de Áú»¢¶Ä²©, cuando name
(nombre visible de equipo) es el mismo que host
(nombre t¨¦cnico de equipo), actualizando host
a trav¨¦s de la API no actualizar¨¢ autom¨¢ticamente la propiedad name
. Ambas propiedades deben ser actualizadas expl¨ªcitamente.
(object)
Devuelve un objeto que contiene los ID de los hosts actualizados bajo la propiedad hostids
.
Habilite el monitoreo del host, es decir, establezca su estado en "0".
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10126",
"status": 0
},
"id": 1
}
Response:
Desvincula y borra dos plantillas del equipo.
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10126",
"templates_clear": [
{
"templateid": "10124"
},
{
"templateid": "10125"
}
]
},
"id": 1
}
Respuesta:
Reemplace todas las macros del equipo por dos nuevas.
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10126",
"macros": [
{
"macro": "{$PASS}",
"value": "password"
},
{
"macro": "{$DISC}",
"value": "sda",
"description": "Updated description"
}
]
},
"id": 1
}
Respuesta:
Cambiar el modo de inventario y agregar ubicaci¨®n
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10387",
"inventory_mode": 0,
"inventory": {
"location": "Latvia, Riga"
}
},
"id": 1
}
Respuesta:
Reemplace todas las etiquetas de equipo por una nueva.
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10387",
"tags": {
"tag": "os",
"value": "rhel-7"
}
},
"id": 1
}
Respuesta:
Convierta la macro "autom¨¢tica" creada por la regla de descubrimiento a "manual" y cambie su valor a "nuevo-valor".
{
"jsonrpc": "2.0",
"method": "host.update",
"params": {
"hostid": "10387",
"macros": {
"hostmacroid": "5541",
"value": "nuevo-valor",
"automatic": "0"
}
},
"id": 1
}
Respuesta:
Actualice el equipo "10590" para usar cifrado PSK solo para conexiones desde el equipo al servidor Áú»¢¶Ä²© y cambie la identidad PSK y la clave PSK. Tenga en cuenta que el equipo debe estar preconfigurado para usar 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
}
Respuesta:
CHost::update() en ui/include/classes/api/services/CHost.php.