hostgroup.update

Descrizione

object hostgroup.update(object/array hostGroups)

Questo metodo consente di aggiornare i gruppi di host esistenti.

Questo metodo è disponibile solo per gli utenti di tipo Admin e Super admin. I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Consultare Ruoli utente per ulteriori informazioni.

Parametri

(object/array) Proprietà del gruppo host da aggiornare.

La proprietà groupid deve essere definita per ciascun gruppo host, tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà specificate, tutte le altre rimarranno invariate.

Valori restituiti

(object) Restituisce un oggetto contenente gli ID dei gruppi di host aggiornati nella proprietà groupids.

Esempi

Rinominare un gruppo di host

Rinomina un gruppo di host in "Linux hosts".

Richiesta:

{
"jsonrpc": "2.0",
"method": "hostgroup.update",
"params": {
"groupid": "7",
"name": "Linux hosts"
},
"id": 1
}

Risposta:

{
"jsonrpc": "2.0",
"result": {
"groupids": [
"7"
]
},
"id": 1
}

Rinomina di più gruppi di host

Rinominare due gruppi di host per includere le informazioni sulla regione nei loro nomi.

Request:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": [
        {
            "groupid": "8",
            "name": "Europe/Linux hosts"
        },
        {
            "groupid": "9",
            "name": "Europe/Windows hosts"
        }
    ],
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "8",
            "9"
        ]
    },
    "id": 1
}

Sorgente

CHostGroup::update() in ui/include/classes/api/services/CHostGroup.php.