hostgroup.update

Description

object hostgroup.update(object/array hostGroups)

Cette méthode vous 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 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/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
}

Renommage de plusieurs groupes d’hôtes

Renommez deux groupes d’hôtes pour inclure des informations de région dans leurs noms.

Requête:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": [
        {
            "groupid": "8",
            "name": "Europe/Linux hosts"
        },
        {
            "groupid": "9",
            "name": "Europe/Windows hosts"
        }
    ],
    "id": 1
}

Réponse :

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

Source

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