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

hostgroup.massremove

Description

object hostgroup.massremove(object parameters)

This method allows to remove related objects from multiple host 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) Parameters containing the IDs of the host groups to update and the objects that should be removed.

Parameter Type Description
groupids
(required)
string/array IDs of the host groups to be updated.
hostids string/array Hosts to remove from all host groups.
templateids string/array Templates to remove from all host groups.

Restituisce i valori

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

Esempi

Removing hosts from host groups

Remove two hosts from the given host groups.

Request:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.massremove",
           "params": {
               "groupids": [
                   "5",
                   "6"
               ],
               "hostids": [
                   "30050",
                   "30001"
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

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

Fonte

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