host.massremove

Description

object host.massremove(object parameters)

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

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 pour plus d'informations.

Paramètres

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

Paramètre Type Description
hostids ID/array ID des hôtes à mettre à jour.

Comportement du paramètre :
- obligatoire
groupids ID/array ID des groupes d’hôtes desquels supprimer les hôtes indiqués.
interfaces object/array Interfaces d’hôte à supprimer des hôtes indiqués.

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 à supprimer des hôtes indiqués.
templateids ID/array ID des modèles à dissocier des hôtes indiqués.
templateids_clear ID/array ID des modèles à dissocier et à supprimer des hôtes indiqués.

Valeurs retournées

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

Exemples

Dissociation de modèles

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

Requête:

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

Réponse :

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

Voir également

Source

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