host.massupdate

Description

object host.massupdate(object parameters)

Cette méthode permet de remplacer ou de supprimer simultanément des objets associés et de mettre à jour les propriétés sur plusieurs hôtes.

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 ID des hôtes à mettre à jour et les propriétés à mettre à jour.

En plus des propriétés de l'objet hôte standard, 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 en remplacement des groupes d'hôtes actuels auxquels appartiennent les hôtes. Les hôtes doivent avoir la propriété `groupid` définie.
interfaces	object/array	Interfaces hôtes en remplacement des interfaces hôtes actuelles sur les hôtes donnés.
inventory	object	Propriétés d'inventaire d'hôte. Le mode d'inventaire de l'hôte ne peut pas être mis à jour à l'aide du paramètre `inventory`, utiliser plutôt `inventory_mode`.
inventory_mode	integer	Mode de peuplement de l'inventaire hôte. Se référer à la page de l'objet Inventaire d'hôte pour une liste des modes d'inventaire supportés.
macros	object/array	Macros utilisateur en remplacement des macros utilisateur actuelles sur les hôtes donnés.
templates	object/array	Modèles en remplacement des modèles actuellement liés sur les hôtes donnés. Les modèles doivent avoir la propriété `templateid` définie.
templates_clear	object/array	Modèles à délier et effacer des 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

Activation de plusieurs hôtes

Activer la surveillance de deux hôtes, c’est-à-dire, définir leur statut à 0.

Requête :

{
           "jsonrpc": "2.0",
           "method": "host.massupdate",
           "params": {
               "hosts": [
                   {
                       "hostid": "69665"
                   },
                   {
                       "hostid": "69666"
                   }
               ],
               "status": 0
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "69665",
                   "69666"
               ]
           },
           "id": 1
       }

Voir également

Source

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

Documentation