[comment]: # ({dd2b9519-dd2b9519})
# host.delete

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

[comment]: # ({4fc1750c-8f1cd3fa})
### Descrição

`object host.delete(array hosts)`

Este método permite excluir hosts.

::: noteclassic
Este método está disponível apenas para os tipos de usuário *Admin* e *Super admin*. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Veja [Funções de usuário](/manual/web_interface/frontend_sections/users/user_roles) para mais informações.
:::

[comment]: # ({/4fc1750c-8f1cd3fa})

[comment]: # ({cede3d95-cede3d95})
### Parâmetros

`(array)` IDs dos hosts a serem excluídos.

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

[comment]: # ({54b4a855-54b4a855})
### Valores de retorno

`(object)` Retorna um objeto contendo os IDs dos hosts excluídos
na propriedade `hostids`.

[comment]: # ({/54b4a855-54b4a855})

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

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

[comment]: # ({47a8da31-ef767d02})
#### Excluindo múltiplos hosts

Exclua dois hosts.

[Requisição](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "host.delete",
    "params": [
        "13",
        "32"
    ],
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "13",
            "32"
        ]
    },
    "id": 1
}
```

[comment]: # ({/47a8da31-ef767d02})

[comment]: # ({9d5f3989-9d5f3989})
### Fonte

CHost::delete() em *ui/include/classes/api/services/CHost.php*.

[comment]: # ({/9d5f3989-9d5f3989})
