Documentation
Table of Contents
host.massadd
Description
object host.massadd(object parameters)
Cette méthode permet d'ajouter simultanément plusieurs objets liés à tous les 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 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 (obligatoire) |
object/array | Hôtes à mettre à jour. Les hôtes doivent avoir la propriété hostid définie. |
| groups | object/array | Groupes d'hôtes à ajouter aux hôtes donnés. Les groupes hôtes doivent avoir la propriété groupid définie. |
| interfaces | object/array | Interfaces hôtes à 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 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": "Test description"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Voir également
Source
CHost::massAdd() dans ui/include/classes/api/services/CHost.php.