host.massadd

Descripció

object host.massadd(object parameters)

Aquest mètode permet afegir simultàniament diversos objectes relacionats a tots els equips donats.

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.

Paràmetres

(object) Paràmetres que contenen ID d'equip per actualitzar i objectes per afegir a tots els equips.

El mètode admet els paràmetres següents.

Paràmetre	Tipus	Descripció
equips	object/array	Equips to be updated a actualitzar. Els equips han de tindre la propietat `hostid` establerta. Comportament de la propietat: - obligatori
grups	object/array	Grups d'equips per afegir als equips donats. Els grups d'equips han de tindre la propietat `groupid` establerta.
interfícies	object/array	Interfícies d'equip per crear per als equips donats.
macros	object/array	Macros d'usuari per crear per als equips donats.
plantilles	object/array	Plantilles per enllaçar amb 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

Afegir macros

Afegeix dues macros noves a dos equips.

Petició:

{  "jsonrpc": "2.0",  "method": "host.massadd",  "params": {  "hosts": [  {  "hostid": "10160"  },  {  "hostid": "10167"  }  ],  "macros": [  {  "macro": "{$TEST1}",  "value": "MACROTEST1"  },  {  "macro": "{$TEST2}",  "value": "MACROTEST2",  "description": "Test description"  }  ]  },  "id": 1 }

Resposta:

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

Veieu també

Font

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

Documentation