[comment]: # translation:outdated

[comment]: # ({2a0a5084-2a0a5084})
## host.massremove

[comment]: # ({/2a0a5084-2a0a5084})

[comment]: # ({9c943195-9c943195})
### Descrição

`object host.massremove(object parameters)`

Este método permite remover objetos relacionados de vários hosts.

::: noteclassic
Este método está disponível apenas para *Admin* e *Superadministrador*
tipos de usuário. As permissões para chamar o método podem ser revogadas na função de usuário
definições. Veja [Usuário
funções](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

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

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

Parâmetros `(object)` contendo os IDs dos hosts a serem atualizados e o
objetos que devem ser removidos.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|---------|----------------------------------- ------------|-----------|
|**hostids**<br>(obrigatório)|string/array|IDs dos hosts a serem atualizados.|
|groupids|string/array|Grupos de hosts dos quais remover os hosts fornecidos.|
|interfaces|object/array|Interfaces de host a serem removidas dos hosts fornecidos.<br><br>O objeto de interface de host deve ter as propriedades `ip`, `dns` e `port` definidas.|
|macros|string/array|Macros de usuário a serem excluídos dos hosts fornecidos.|
|templateids|string/array|Modelos para desvincular dos hosts fornecidos.|
|templateids\_clear|string/array|Modelos para desvincular e limpar dos hosts fornecidos.|

[comment]: # ({/689d39a3-689d39a3})

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

`(object)` Retorna um objeto contendo os IDs dos hosts atualizados
sob a propriedade `hostids`.

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

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

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

[comment]: # ({8c635a7b-8c635a7b})
#### Desvinculando modelos

Desvincule um modelo de dois hosts e exclua todos os modelos
entidades.

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "host.massremove",
    "parâmetros": {
        "hostids": ["69665", "69666"],
        "templateids_clear": "325"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": {
        "hostids": [
            "69665",
            "69666"
        ]
    },
    "id": 1
}
```

[comment]: # ({/8c635a7b-8c635a7b})

[comment]: # ({abd9a8d3-abd9a8d3})
### Veja também

- [host.update](atualização)
-   [Do utilizador
    macro](/manual/api/reference/usermacro/object#hosttemplate_level_macro)
-   [Hospedeiro
    interface](/manual/api/reference/hostinterface/object#host_interface)

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

[comment]: # ({bda21fe6-bda21fe6})
### Fonte

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

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