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.