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'utilisateur Admin et Super admin. Les autorisations d'appel de cette méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Consultez Rôles utilisateur pour plus d'informations.

Paramètres

(object) Paramètres contenant les IDs des groupes d'hôtes à mettre à jour et les objets qui doivent être mis à jour.

Parameter 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 du paramètre:
- required
hosts object/array Hôtes à remplacer les hôtes actuels dans les groupes d'hôtes donnés.
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 hôtes doivent avoir uniquement la propriété hostid définie.

Comportement du paramètre:
- required

Valeurs retournées

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

Exemples

Remplacement des hôtes dans un groupe d'hôtes

Remplacez tous les hôtes d'un groupe d'hôtes par l'hôte mentionné.

Requête :

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

Réponse :

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

Voir aussi

Source

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