host.massadd

Descrizione

object host.massadd(object parameters)

Questo metodo consente di aggiungere simultaneamente più oggetti correlati a tutti gli host specificati.

Questo metodo è disponibile solo per i tipi di utente Admin e Super admin. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere User roles.

Parametri

(object) Parametri contenenti gli ID degli host da aggiornare e gli oggetti da aggiungere a tutti gli host.

Il metodo accetta i seguenti parametri.

Parametro Tipo Descrizione
hosts object/array Host da aggiornare.

Gli host devono avere definita solo la proprietà hostid.

Comportamento dei parametri:
- obbligatorio
groups object/array Gruppi di host da aggiungere agli host specificati.

I gruppi di host devono avere definita solo la proprietà groupid.
interfaces object/array Interfacce host da creare per gli host specificati.
macros object/array Macro utente da creare per gli host specificati.
templates object/array Template da collegare agli 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

Aggiunta di macro

Aggiungere due nuove macro a due host.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "host.massadd",
    "params": {
        "hosts": [
            {
                "hostid": "10160"
            },
            {
                "hostid": "10167"
            }
        ],
        "macros": [
            {
                "macro": "{$TEST1}",
                "value": "MACROTEST1"
            },
            {
                "macro": "{$TEST2}",
                "value": "MACROTEST2",
                "description": "Descrizione di test"
            }
        ]
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10160",
            "10167"
        ]
    },
    "id": 1
}

Vedi anche

Fonte

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