maintenance.update

Descripció

object maintenance.update(object/array maintenances)

Aquest mètode permet actualitzar manteniments.

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/array) Propietats del manteniment per actualitzar.

La propietat maintenanceid s'ha d'establir per a cada manteniment, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.

A més de les propietats de manteniment estàndard, el mètode admet els paràmetres següents.

Paràmetre	Tipus	Descripció
groups	object/array	Grups d'equips substituint els grups actuals. Els grups d'equips han de tindre la propietat `groupid` establerta. Comportament de la propietat: - obligatori si `hosts` no s'ha definit
hosts	object/array	Equips substituint els equips actuals. Els equips han de tindre la propietat `hostid` establerta. Comportament de la propietat: - obligatori si `groups` no s'ha definit
timeperiods	object/array	Períodes substituint els períodes actuals.
tags	object/array	Etiquetes del problema substituint les etiquetes actuals. Comportament de la propietat: - admès si `maintenance_type` de l'objecte manteniment s'ha establert a "amb recollida de dades"
groupids (obsolet)	array	Aquest paràmetre és obsolet; si us plau, empreu `groups`. ID dels grups d'equips que es sotmetran a manteniment.
hostids (obsolet)	array	Aquest paràmetre és obsolet, si us plau, empreu `hosts` en el seu lloc. ID dels equips que es sotmetran a manteniment.

Valors de retorn

(object) Torna un objecte que contingui els IDs dels manteniments actualitzats sota la propietat maintenanceids.

Exemples

Assignar diferents equips

Reemplaçar els equips actualment afectats pel manteniment amb dos equips diferents.

Petició:

{
           "jsonrpc": "2.0",
           "method": "maintenance.update",
           "params": {
               "maintenanceid": "3",
               "hosts": [
                   {"hostid": "10085"},
                   {"hostid": "10084"}
               ]
           },
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "maintenanceids": [
                   "3"
               ]
           },
           "id": 1
       }

Veieu també

Període

Font

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

Documentation