[comment]: # translation:outdated

[comment]: # ({6a96957a-6a96957a})
# hostgroup.delete

[comment]: # ({/6a96957a-6a96957a})

[comment]: # ({849053ec-3c7f9c00})
### Beschrijving

`object hostgroup.delete(array hostGroupIds)`

Met deze methode kunnen host groepen worden verwijderd.

Een host groep kan niet worden verwijderd als deze:

- hosts bevat die alleen tot deze groep behoren;
- is gemarkeerd als intern;
- wordt gebruikt door een host-prototype;
- wordt gebruikt in een globaal script;
- wordt gebruikt in een correlatieconditie.

::: noteclassic
Deze methode is alleen beschikbaar voor *Admin* en *Super admin*
gebruikers typen. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol
instellingen. Zie [Gebruiker
rollen](/manual/web_interface/frontend_sections/users/user_roles)
voor meer informatie.
:::

[comment]: # ({/849053ec-3c7f9c00})

[comment]: # ({af1f0187-af1f0187})
### Parameters

`(array)` ID's van de te verwijderen hostgroepen.

[comment]: # ({/af1f0187-af1f0187})

[comment]: # ({288daefc-288daefc})
### Retourwaarden

`(object)` Retourneert een object dat de ID's van de verwijderde host groepen bevat onder de eigenschap `groupids`.

[comment]: # ({/288daefc-288daefc})

[comment]: # ({b41637d2-b41637d2})
### Voorbeelden

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({4122f4d9-a6d8d11e})
#### Het verwijderen van meerdere hostgroepen

Verwijder twee hostgroepen.

[Aanvraag](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "hostgroup.delete",
    "params": [
        "107824",
        "107825"
    ],
    "id": 1
}
```

Reactie:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "107824",
            "107825"
        ]
    },
    "id": 1
}
```

[comment]: # ({/4122f4d9-a6d8d11e})

[comment]: # ({f496d50e-f496d50e})
### Bron

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

[comment]: # ({/f496d50e-f496d50e})