hostgroup.massupdate

Description

object hostgroup.massupdate(object parameters)

Cette méthode permet de remplacer les hôtes et les modèles par ceux spécifiés dans plusieurs groupes d'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 groupes d'hôtes à mettre à jour et les objets à mettre à jour.

Paramètre	Type	Description
groups (obligatoire)	object/array	Groupes d'hôtes à mettre à jour. Tous les autres hôtes, à l'exception de ceux mentionnés, seront exclus des groupes d'hôtes. Les hôtes découverts ne seront pas affectés. Les groupes hôtes doivent avoir la propriété `groupid` définie.
hosts	object/array	Hôtes en remplacement des hôtes actuels sur les groupes d'hôtes donnés. Les hôtes doivent avoir la propriété `hostid` définie.
templates	object/array	Modèles en remplacement des modèles actuels sur les groupes d'hôtes donnés. Tous les autres modèles, à l'exception de ceux mentionnés, seront exclus des groupes d'hôtes. Les modèles doivent avoir la propriété `templateid` définie.

Valeurs retournées

(object) Renvoie un objet contenant les identifiants des groupes d'hôtes mis à jour sous la propriété groupids.

Exemples

Remplacement d'hôtes et de modèles dans un groupe d'hôtes

Remplacez tous les hôtes d'un groupe d'hôtes par ceux mentionnés et dissociez tous les modèles du groupe d'hôtes.

Requête :

{
           "jsonrpc": "2.0",
           "method": "hostgroup.massupdate",
           "params": {
               "groups": [
                   {
                       "groupid": "6"
                   }
               ],
               "hosts": [
                   {
                       "hostid": "30050"
                   }
               ],
               "templates": []
           },
           "auth": "f223adf833b2bf2ff38574a67bba6372",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": {
               "groupids": [
                   "6",
               ]
           },
           "id": 1
       }

Voir également

Source

CHostGroup::massUpdate() dans ui/include/classes/api/services/CHostGroup.php.

Documentation