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.

Documentation