hostgroup.update

Descrizione

object hostgroup.update(object/array hostGroups)

Questo metodo consente di aggiornare i gruppi di host 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 dei ruoli utente. Per ulteriori informazioni, vedere Ruoli utente.

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.