Áú»¢¶Ä²©

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.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ

(object) ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ 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.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð Type Description
hosts
(obligatoire)
object/array H?tes ¨¤ mettre ¨¤ jour.

Les h?tes doivent avoir la propri¨¦t¨¦ hostid »å¨¦´Ú¾±²Ô¾±±ð.
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 »å¨¦´Ú¾±²Ô¾±±ð.
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 ²Ñ´Ç»å¨¨±ô±ðs en remplacement des mod¨¨les actuellement li¨¦s sur les h?tes donn¨¦s.

Les mod¨¨les doivent avoir la propri¨¦t¨¦ templateid »å¨¦´Ú¾±²Ô¾±±ð.
templates_clear object/array ²Ñ´Ç»å¨¨±ô±ðs ¨¤ d¨¦lier et effacer des h?tes donn¨¦s.

Les mod¨¨les doivent avoir la propri¨¦t¨¦ templateid »å¨¦´Ú¾±²Ô¾±±ð.

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.