hostgroup.massadd
Description
object hostgroup.massadd(object parameters)
Cette méthode permet d'ajouter simultanément plusieurs objets liés à tous les groupes d'hôtes donnés.
Cette méthode est disponible uniquement pour les types d'utilisateur Admin et Super admin. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Voir User roles 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.
{
"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.