Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

hostgroup.massadd

Description

object hostgroup.massadd(object parameters)

Cette méthode permet d'ajouter simultanément plusieurs objets associés à tous les groupes d'hôtes donnés.

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 à ajouter à tous les groupes d'hôtes.

La méthode accepte les paramètres suivants.

Paramètre Type Description
groups
(obligatoire)
object/array Groupes d'hôtes à mettre à jour.

Les groupes d'hôtes doivent avoir la propriété groupid définie.
hosts object/array Hôtes à ajouter à tous les groupes d'hôtes.

Les hôtes doivent avoir la propriété hostid définie.
templates object/array Modèles à ajouter à tous les 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

Ajout d'hôtes aux groupes d'hôtes

Ajoutez deux hôtes aux groupes d'hôtes avec les ID 5 et 6.

Requête :

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

Réponse :

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

Voir également

Source

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