hostgroup.massadd
Description
object hostgroup.massadd(object parameters)
Cette méthode permet d'ajouter simultanément plusieurs objets associés à tous les groupes d'hôtes donnés.
Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir Rôles Utilisateur pour plus d'informations.
Paramètres
(object) Paramètres contenant les identifiants 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 (obligatoire) |
object/array | Groupes d'hôtes à mettre à jour. Les groupes d'hôtes doivent avoir la propriété groupid définie. |
| hosts | object/array | Hôtes à ajouter à tous les groupes d'hôtes. Les hôtes doivent avoir la propriété hostid définie. |
| templates | object/array | Modèles à ajouter à tous les groupes d'hôtes. Les modèles doivent avoir la propriété templateid 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 aux groupes d'hôtes
Ajoutez deux hôtes aux groupes d'hôtes avec les ID 5 et 6.
Requête :
{
"jsonrpc": "2.0",
"method": "hostgroup.massadd",
"params": {
"groups": [
{
"groupid": "5"
},
{
"groupid": "6"
}
],
"hosts": [
{
"hostid": "30050"
},
{
"hostid": "30001"
}
]
},
"auth": "f223adf833b2bf2ff38574a67bba6372",
"id": 1
}Réponse :
{
"jsonrpc": "2.0",
"result": {
"groupids": [
"5",
"6"
]
},
"id": 1
}Voir également
Source
CHostGroup::massAdd() dans ui/include/classes/api/services/CHostGroup.php.