Áú»¢¶Ä²©

This is a translation of the original English documentation page. Help us make it better.

host.update

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

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.

Valors de retorn

(object) Retorna un objecte contingut als IDs dels equips actualitzats sota la propietat hostids.

Exemples

Activar un equip

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:

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

Desenlla?ar plantilles

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:

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

Actualitzar les macros d'equips

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:

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

Actualitzar l'inventari d'equips

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:

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

Actualitzar les etiquetes d'equips

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:

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

Actualitzar les macros d'equip descobertes

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:

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

Actualitzant el xifrat d'equip

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:

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

Veieu tamb¨¦

Font

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