[comment]: # translation:outdated

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

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

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

`object hostgroup.delete(array hostGroupIds)`

Questo metodo consente di eliminare gruppi di host.

Un gruppo di host non può essere eliminato se:

- contiene host che appartengono solo a questo gruppo;
- è contrassegnato come interno;
- è utilizzato da un prototipo di host;
- è utilizzato in uno script globale;
- è utilizzato in una condizione di correlazione.

::: noteclassic
Questo metodo è disponibile solo per gli utenti di tipo *Admin* e *Super admin*.
Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo
utente. Consultare [Ruoli
utente](/manual/web_interface/frontend_sections/users/user_roles)
per ulteriori informazioni.
:::

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

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

`(array)` ID dei gruppi di host da eliminare.

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

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

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

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

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

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

[comment]: # ({4122f4d9-a6d8d11e})
#### Eliminare molteplici gruppi di host

Elimina due gruppi di host.

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

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

Risposta:

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

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

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

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

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