maintenance.update

Descrizione

object maintenance.update(object/array maintenances)

Questo metodo consente di aggiornare maintenance esistenti.

Questo metodo è disponibile solo per i tipi di utente Admin e Super admin. I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere Ruoli utente.

Parametri

(object/array) Proprietà della manutenzione da aggiornare.

La proprietà maintenanceid deve essere definita per ogni manutenzione; tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, mentre tutte le altre rimarranno invariate.

Oltre alle proprietà standard della manutenzione, il metodo accetta i seguenti parametri.

Parameter Type Description
groups object/array Host groups da sostituire ai gruppi correnti.

I gruppi host devono avere definita solo la proprietà groupid.

Comportamento del parametro:
- required se hosts non è impostato
hosts object/array Hosts da sostituire agli host correnti.

Gli host devono avere definita solo la proprietà hostid.

Comportamento del parametro:
- required se groups non è impostato
timeperiods object/array Periodi di tempo della manutenzione da sostituire ai periodi correnti.
tags object/array Tag del problema da sostituire ai tag correnti.

Comportamento del parametro:
- supported se maintenance_type dell'oggetto Maintenance è impostato su "with data collection"
groupids
(deprecated)		 array Questo parametro è deprecato, usare invece groups.
ID dei gruppi host che saranno sottoposti a manutenzione.
hostids
(deprecated)		 array Questo parametro è deprecato, usare invece hosts.
ID degli host che saranno sottoposti a manutenzione.

Valori restituiti

"(object)" Restituisce un oggetto contenente gli ID dell'oggetto aggiornato manutenzioni sotto la proprietà maintenanceids.

Esempi

Assegnazione di host diversi

Sostituisci gli host attualmente assegnati alla manutenzione con altri due.

Richiesta:

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

Risposta:

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

Vedi anche

Fonte

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