maintenance.update

Descrizione

object maintenance.update(object/array maintenances)

Questo metodo consente di aggiornare le maintenances esistenti.

Questo metodo è disponibile solo per i tipi di utente Admin e Super admin. Le autorizzazioni per richiamare il metodo possono essere revocate 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.

Parametro Tipo Descrizione
groups object/array Gruppi di host con cui 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 con cui sostituire gli host correnti.

Gli host devono avere definita solo la proprietà hostid.

Comportamento del parametro:
- obbligatorio se groups non è impostato
triggers object/array Trigger con cui sostituire i trigger correnti.

I trigger devono avere definita solo la proprietà triggerid.

Comportamento del parametro:
- obbligatorio se groups e hosts non sono impostati
- supportato se maintenance_type=0 (con raccolta dati)
event_names object/array Nomi degli eventi con cui sostituire i nomi degli eventi correnti.

Comportamento del parametro:
- supportato se maintenance_type=0 (con raccolta dati)
tags object/array Tag dei problemi con cui sostituire i tag correnti.

Comportamento del parametro:
- supportato se maintenance_type dell'oggetto Maintenance è impostato su "con raccolta dati"
timeperiods object/array Periodi di tempo della manutenzione con cui sostituire i periodi correnti.

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.