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

hostgroup.delete

Description

object hostgroup.delete(array hostGroupIds)

This method allows to delete host groups.

A host group can not be deleted if:

  • it contains hosts that belong to this group only;
  • it is marked as internal;
  • it is used by a host prototype;
  • it is used in a global script;
  • it is used in a correlation condition.

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.

Paraméterek

A törölni kívánt gazdagépcsoportok `(tömb) azonosítói.

Visszatérési értékek

(object) Egy objektumot ad vissza, amely tartalmazza a törölt gazdagép azonosítóit csoportok a "groupids" tulajdonság alatt.

Példák

Deleting multiple host groups

Delete two host groups.

Request:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.delete",
           "params": [
               "107824",
               "107825"
           ],
           "auth": "3a57200802b24cda67c4e4010b50c065",
           "id": 1
       }
Copy
✔ Copied

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "groupids": [
                   "107824",
                   "107825"
               ]
           },
           "id": 1
       }
Copy
✔ Copied

Forrás

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

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.