Sidebar
fr:manual:api:reference:host:massadd
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.
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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }
Réponse :
{ "jsonrpc": "2.0", "result": { "hostids": [ "10160", "10167" ] }, "id": 1 }
Voir également
Source
CHost::massAdd() dans frontends/php/include/classes/api/services/CHost.php.