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, tutte le altre rimarranno invariate.

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

Parameter Type Description
groups object/array Gruppi di host per sostituire i gruppi correnti.

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

Comportamento del parametro:
- obbligatorio se hosts non è impostato
hosts object/array Host per sostituire gli host correnti.

Gli host devono avere definita solo la proprietà hostid.

Comportamento del parametro:
- obbligatorio se groups non è impostato
timeperiods object/array Periodi temporali della manutenzione per sostituire i periodi correnti.
tags object/array Tag dei problemi per sostituire i tag correnti.

Comportamento del parametro:
- supportato se maintenance_type dell'oggetto manutenzione è impostato su "with data collection"

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.