host.massadd
Description
object host.massadd(object parameters)
Cette méthode permet d’ajouter simultanément plusieurs objets associés à tous les 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 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 également
Source
CHost::massAdd() dans ui/include/classes/api/services/CHost.php.