Áú»¢¶Ä²©

host.massupdate

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

object host.massupdate(object parameters)

Aquest m¨¨tode permet substituir o esborrar simult¨¤niament els objectes associats i actualitzar les propietats sobre diversos equips.

Tenim aquest m¨¨tode disponible nom¨¦s per als usuaris Admin i Super admin. Els permisos per cridar el m¨¨tode es poden revocar a la configuraci¨® dels rols d'usuari. Per a m¨¦s informaci¨®, veieu Rols d'usuari.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ

(object) ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ que contenen els ID d'equip que cal actualitzar i les propietats que cal actualitzar.

A m¨¦s de les [propietats de l'objecte equip est¨¤ndard] (object#host), el m¨¨tode admet els par¨¤metres seg¨¹ents.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð Tipus ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
hosts object/array Equips per actualitzar.

Els equips han de tindre la propietat hostid establerta.

Comportament de la propietat:
- obligatori
groups object/array Grups d'equips substituint els grups d'equips actuals als quals pertanyen els equips.

Els equips han de tindre definida la propietat groupid.
interfaces object/array Interf¨ªcies d'equip substituint les interf¨ªcies d'equip actuals als equips donats.
inventory object Les propietats d'inventari de l'equip.

El mode d'inventari de l'equip no es pot pas actualitzar mitjan?ant el par¨¤metre inventory; empreu inventory_mode en canvi.
macros object/array Macros d'usuari substituint les macros d'usuari actuals als equips determinats.
templates object/array Plantilles que substitueixen les plantilles enlla?ades actualment als equips donats.

Les plantilles han de tindre la propietat templateid definida.
templates_clear object/array Plantilles per desenlla?ar i esborrar els equips donats.

Les plantilles han de tindre la propietat templateid establerta.

Valors de retorn

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

Exemples

Habilitar m¨²ltiples equips

Habilitar el monitoratge de dos equips; ¨¦s a dir, defineix el seu estat a "0".

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "jsonrpc": "2.0",
           "method": "host.massupdate",
           "params": {
               "hosts": [
                   {
                       "hostid": "69665"
                   },
                   {
                       "hostid": "69666"
                   }
               ],
               "status": 0
           },
           "id": 1
       }

Resposta:

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

Veieu tamb¨¦

Font

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