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 indiqués.

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

Paramètres

(object) Paramètres contenant les ID 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 object/array Groupes d’hôtes à mettre à jour.

Les groupes d’hôtes doivent avoir uniquement la propriété groupid définie.

Comportement des paramètres :
- obligatoire
hosts object/array Hôtes à ajouter à tous les groupes d’hôtes.

Les hôtes doivent avoir uniquement la propriété hostid 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 à des groupes d'hôtes

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

Requête:

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

Réponse :

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

Voir aussi

Source

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