Áú»¢¶Ä²©

host.update

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô

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 groupidpropiedad 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.

Valores devueltos

(object) Devuelve un objeto que contiene los ID de los hosts actualizados bajo la propiedad hostids.

Ejemplos

Habilitaci¨®n de un host

Habilite el monitoreo del host, es decir, establezca su estado en "0".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10126",
               "status": 0
           },
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10126"
               ]
           },
           "id": 1
       }

Desvincular plantillas

Desvincula y borra dos plantillas del equipo.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10126",
               "templates_clear": [
                   {
                       "templateid": "10124"
                   },
                   {
                       "templateid": "10125"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10126"
               ]
           },
           "id": 1
       }

Actualizaci¨®n de macros de equipo

Reemplace todas las macros del equipo por dos nuevas.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10126",
               "macros": [
                   {
                       "macro": "{$PASS}",
                       "value": "password"
                   },
                   {
                       "macro": "{$DISC}",
                       "value": "sda",
                       "description": "Updated description"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10126"
               ]
           },
           "id": 1
       }

Actualizando el inventario de equipo

Cambiar el modo de inventario y agregar ubicaci¨®n

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10387",
               "inventory_mode": 0,
               "inventory": {
                   "location": "Latvia, Riga"
               }
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10387"
               ]
           },
           "id": 1
       }

Actualizaci¨®n de etiquetas de equipo

Reemplace todas las etiquetas de equipo por una nueva.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10387",
               "tags": {
                   "tag": "os",
                   "value": "rhel-7"
               }
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10387"
               ]
           },
           "id": 1
       }

Actualizaci¨®n de macros de equipos descubiertos

Convierta la macro "autom¨¢tica" creada por la regla de descubrimiento a "manual" y cambie su valor a "nuevo-valor".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10387",
               "macros": {
                   "hostmacroid": "5541",
                   "value": "nuevo-valor",
                   "automatic": "0"
               }
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10387"
               ]
           },
           "id": 1
       }

Actualizaci¨®n del cifrado del equipo

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.

Solicitud:

{
           "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:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10590"
               ]
           },
           "id": 1
       }

Ver tambi¨¦n

Fuente

CHost::update() en ui/include/classes/api/services/CHost.php.