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 des groupes d'hôtes à mettre à jour.
La propriété groupeid doit être définie pour chaque groupe d'hôtes. Toutes les autres propriétés sont facultatives. Seules les propriétés transmises 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 ».
{
"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.
{
"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.