host.massremove

Description

object host.massremove(object parameters)

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

Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir Rôles Utilisateur pour plus d'informations.

Paramètres

(object) Paramètres contenant les identifiants des hôtes à mettre à jour et les objets à supprimer.

Paramètre Type Description
hostids
(obligatoire)
string/array ID des hôtes à mettre à jour.
groupids string/array Groupes d'hôtes desquels supprimer les hôtes donnés.
interfaces object/array Interfaces hôtes à supprimer des hôtes donnés.

L'objet d'interface hôte doit avoir les propriétés ip, dns et port définies.
macros string/array Macros utilisateur à supprimer des hôtes donnés.
templateids string/array Modèles à délier des hôtes donnés.
templateids_clear string/array Modèles à délier et effacer des hôtes donnés.

Valeurs retournées

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

Exemples

Dissociation des modèles

Délier un modèle de deux hôtes et supprimer toutes les entités basées sur ce modèle.

Requête :

{
           "jsonrpc": "2.0",
           "method": "host.massremove",
           "params": {
               "hostids": ["69665", "69666"],
               "templateids_clear": "325"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "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.