host.massupdate

Descrizione

object host.massupdate(object parameters)

Questo metodo consente di sostituire o rimuovere simultaneamente gli oggetti correlati e aggiornare le proprietà di più host.

Questo metodo è disponibile solo per i tipi di utente Admin e Super admin. Le autorizzazioni per richiamare il metodo possono essere revocate nelle impostazioni dei ruoli utente. Per ulteriori informazioni, vedere Ruoli utente.

Parametri

(object) Parametri contenenti gli ID degli host da aggiornare e le proprietà che devono essere aggiornate.

Oltre alle proprietà standard dell'host, il metodo accetta i seguenti parametri.

Parameter Type Description
hosts object/array Host da aggiornare.

Gli host devono avere definita solo la proprietà hostid.

Comportamento del parametro:
- required
groups object/array Gruppi host da sostituire ai gruppi host correnti a cui appartengono gli host.

I gruppi host devono avere definita solo la proprietà groupid.
interfaces object/array Interfacce host da sostituire alle interfacce host correnti sui host specificati.
inventory object Proprietà dell'inventario host.

La modalità di inventario host non può essere aggiornata usando il parametro inventory; usare invece inventory_mode.
macros object/array Macro utente da sostituire alle macro utente correnti sui host specificati.
templates object/array Template da sostituire ai template attualmente collegati sui host specificati.

I template devono avere definita solo la proprietà templateid.
templates_clear object/array Template da scollegare e rimuovere dai host specificati.

I template devono avere definita solo la proprietà templateid.

Valori di ritorno

(object) Restituisce un oggetto contenente gli ID degli host aggiornati sotto la proprietà hostids.

Esempi

Abilitazione di più host

Abilita il monitoraggio di due host, ovvero imposta il loro stato su "0".

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "host.massupdate",
    "params": {
        "hosts": [
            {
                "hostid": "69665"
            },
            {
                "hostid": "69666"
            }
        ],
        "status": 0
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "69665",
            "69666"
        ]
    },
    "id": 1
}

Vedi anche

Fonte

CHost::massUpdate() in ui/include/classes/api/services/CHost.php.