You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

host.massupdate

Descripció

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.

Paràmetres

(object) Paràmetres 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.

Paràmetre Tipus Descripció
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".

Petició:

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