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.