host.massadd
Description
object host.massadd(object parameters)
Cette méthode permet d’ajouter simultanément plusieurs objets associés à tous les hôtes indiqués.
Cette méthode est uniquement disponible pour les types d’utilisateurs Admin et Super admin. Les autorisations d’appeler cette méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Consultez la page Rôles utilisateur pour plus d’informations.
Paramètres
(object) Paramètres contenant les ID des hôtes à mettre à jour et les objets à ajouter à tous les hôtes.
La méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| hosts | object/array | Hôtes à mettre à jour. Les hôtes doivent avoir uniquement la propriété hostid définie.Comportement des paramètres : - obligatoire |
| groups | object/array | Groupes d'hôtes à ajouter aux hôtes donnés. Les groupes d'hôtes doivent avoir uniquement la propriété groupid définie. |
| interfaces | object/array | Interfaces d'hôte à créer pour les hôtes donnés. |
| macros | object/array | Macros utilisateur à créer pour les hôtes donnés. |
| templates | object/array | Modèles à lier aux hôtes donnés. Les modèles doivent avoir uniquement la propriété templateid définie. |
Valeurs retournées
(object) Retourne un objet contenant les identifiants des hôtes mis à jour sous la propriété hostids.
Exemples
Ajout de macros
Ajoutez deux nouvelles macros à deux hôtes.
Requête :
{
"jsonrpc": "2.0",
"method": "host.massadd",
"params": {
"hosts": [
{
"hostid": "10160"
},
{
"hostid": "10167"
}
],
"macros": [
{
"macro": "{$TEST1}",
"value": "MACROTEST1"
},
{
"macro": "{$TEST2}",
"value": "MACROTEST2",
"description": "Description de test"
}
]
},
"id": 1
}Réponse :
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"10160",
"10167"
]
},
"id": 1
}Voir aussi
Source
CHost::massAdd() dans ui/include/classes/api/services/CHost.php.