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 sugli host specificati.
inventory object Proprietà dell'inventario host.

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

I template devono avere definita solo la proprietà templateid.
templates_clear object/array Template da scollegare e rimuovere dagli 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, cioè 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
}

Guarda anche

Fonte

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