[comment]: # translation:outdated

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

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

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

`object host.massremove(object parameters)`

Cette méthode permet de supprimer des objets associés de plusieurs hôtes.

::: noteclassic
Cette méthode est disponible uniquement pour les types d'utilisateur *Admin* et *Super admin*.
Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur.
Voir [User
roles](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d'informations.
:::

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

[comment]: # ({7774cf37-689d39a3})
### Paramètres

`(object)` Paramètres contenant les ID des hôtes à mettre à jour et les
objets qui doivent être supprimés.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|hostids|ID/array|ID des hôtes à mettre à jour.<br><br>[Comportement des paramètres](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire*|
|groupids|ID/array|ID des [groupes d'hôtes](/manual/api/reference/hostgroup/object) desquels supprimer les hôtes donnés.|
|interfaces|object/array|[Interfaces d'hôte](/manual/api/reference/hostinterface/object) à supprimer des hôtes donnés.<br><br>L'objet d'interface d'hôte doit avoir uniquement les propriétés `ip`, `dns` et `port` définies.|
|macros|string/array|[Macros utilisateur](/manual/api/reference/usermacro/object) à supprimer des hôtes donnés.|
|templateids|ID/array|ID des [modèles](/manual/api/reference/template/object) à dissocier des hôtes donnés.|
|templateids\_clear|ID/array|ID des [modèles](/manual/api/reference/template/object) à dissocier et supprimer des hôtes donnés.|

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

[comment]: # ({d166b99b-d166b99b})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des hôtes mis à jour sous la propriété `hostids`.

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

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

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

[comment]: # ({e1df8faa-8c635a7b})
#### Dissociation de modèles

Dissociez un modèle de deux hôtes et supprimez toutes les entités
issues du modèle.

[Requête](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "host.massremove",
    "params": {
        "hostids": ["69665", "69666"],
        "templateids_clear": "325"
    },
    "id": 1
}
```

Réponse :

```json
{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "69665",
            "69666"
        ]
    },
    "id": 1
}
```

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

[comment]: # ({48715467-abd9a8d3})
### Voir aussi

-   [host.update](update)
-   [Macro
    utilisateur](/manual/api/reference/usermacro/object#hosttemplate-level-macro)
-   [Interface
    d'hôte](/manual/api/reference/hostinterface/object#host-interface)

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

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

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

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