This is a translation of the original English documentation page. Help us make it better.

hostgroup.update

Description

object hostgroup.update(object/array hostGroups)

This method allows to update existing hosts groups.

This method is only available to Admin and Super admin user types. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parameters

(object/array) Host group properties to be updated.

The groupid property must be defined for each host group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged.

Restituisce i valori

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

Esempi

Renaming a host group

Rename a host group to "Linux hosts."

Request:

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

Response:

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

Fonte

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