[comment]: # translation:outdated

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

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

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

`object hostgroup.delete(array hostGroupIds)`

Diese Methode ermöglicht das Löschen von Host-Gruppen.

Eine Host-Gruppe kann nicht gelöscht werden, wenn:

-   sie Hosts enthält, die nur zu dieser Gruppe gehören;
-   sie als intern markiert ist;
-   sie von einem Host-Prototyp verwendet wird;
-   sie in einem globalen Skript verwendet wird;
-   sie in einer Korrelationsbedingung verwendet wird.

::: noteclassic
Diese Methode ist nur für die Benutzertypen *Admin* und *Super admin*
verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den
Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen
finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(array)` IDs der zu löschenden Hostgruppen.

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

[comment]: # ({288daefc-288daefc})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der gelöschten Host-Gruppen
unter der Eigenschaft `groupids` enthält.

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

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

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

[comment]: # ({4122f4d9-a6d8d11e})
#### Mehrere Host-Gruppen löschen

Löschen Sie zwei Host-Gruppen.

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

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

Antwort:

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

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

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

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

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