Sidebar
fr:manual:api:reference:host:massupdate
Table of Contents
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.