hostgroup.update

Description

object hostgroup.update(object/array hostGroups)

Cette méthode permet de mettre à jour des groupes d’hôtes existants.

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

Paramètres

(object/array) Propriétés du groupe d'hôtes à mettre à jour.

La propriété groupid doit être définie pour chaque groupe d'hôtes, toutes les autres propriétés sont facultatives. Seules les propriétés indiquées seront mises à jour, toutes les autres resteront inchangées.

Valeurs retournées

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

Exemples

Renommer un groupe d’hôtes

Renommez un groupe d’hôtes en « Linux hosts ».

Requête:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": {
        "groupid": "7",
        "name": "Linux hosts"
    },
    "id": 1
}

Réponse :

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

Source

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