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 :

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "10160",
                   "10167"
               ]
           },
           "id": 1
       }

Voir également

Source

CHost::massAdd() dans ui/include/classes/api/services/CHost.php.

Documentation