[comment]: # ({ae0db7b8-ae0db7b8})
# template.massremove

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

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

`object template.massremove(object parameters)`

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

::: 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. Consulte [função do
usuário](/manual/web_interface/frontend_sections/administration/user_roles)
para obter mais informações.
:::

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

[comment]: # ({7ce45f78-bd7f8b44})
### Parâmetros

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

|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|--|--|------|
|**templateids**<br>(required)|string/array|IDs dos templates a serem atualizados.|
|groupids|string/array|Grupos de hosts dos quais remover os templates fornecidos.|
|macros|string/array|Macros de usuário para excluir dos templates fornecidos.|
|templateids\_clear|string/array|Templates para desvincular e limpar dos templates fornecidos (upstream).|
|templateids\_link|string/array|Templates para desvincular dos templates fornecidos (upstream).|

[comment]: # ({/7ce45f78-bd7f8b44})

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

`(object)` Retorna um objeto contendo os IDs dos modelos atualizados na
propriedade `templateids`.

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

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

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

[comment]: # ({02a4a7dd-20c1ddc2})
#### Removendo templates de um grupo

Remover 2 templates do grupo "2".

Requisição:

```json
{
    "jsonrpc": "2.0",
    "method": "template.massremove",
    "params": {
        "templateids": [
            "10085",
            "10086"
        ],
        "groupids": "2"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10085",
            "10086"
        ]
    },
    "id": 1
}
```

[comment]: # ({/02a4a7dd-20c1ddc2})

[comment]: # ({7c6641ff-5ec690e5})
#### Desvinculando templates de um host

Desvincule os templates "10106", "10104" do template "10085".

Requisição:

```json
{
    "jsonrpc": "2.0",
    "method": "template.massremove",
    "params": {
        "templateids": "10085",
        "templateids_link": [
            "10106",
            "10104"
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10085"
        ]
    },
    "id": 1
}
```

[comment]: # ({/7c6641ff-5ec690e5})

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

-   [template.update](update)
-   [macro de usuário](/manual/api/reference/usermacro/object#hosttemplate_level_macro)

[comment]: # ({/186aec66-186aec66})

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

CTemplate::massRemove() in
*ui/include/classes/api/services/CTemplate.php*.

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