Sidebar

Zabbix Summit 2022
View presentations

host.massremove

Description

object host.massremove(object parameters)

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

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 frontends/php/include/classes/api/services/CHost.php.