host.massupdate

Description

object host.massupdate(object parameters)

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

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.

Exmples

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 frontends/php/include/classes/api/services/CHost.php.

Documentation