[comment]: # ({4a6b3375-4a6b3375})
# host.massupdate

[comment]: # ({/4a6b3375-4a6b3375})

[comment]: # ({e22b9f8f-7a41ce27})
### 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.

[comment]: # ({/e22b9f8f-7a41ce27})

[comment]: # ({b5ea5d84-7b73358f})
### 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](/fr/manual/api/reference/host/object#hote), la méthode accepte
les paramètres suivants.

|Paramètre|Type|Description|
|----------|----|-----------|
|**hosts**<br>(obligatoire)|object/array|Hôtes à mettre à jour.<br><br>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.<br><br>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.<br><br>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.<br><br>Se référer à la [page de l'objet Inventaire d'hôte](/fr/manual/api/reference/host/object#inventaire_d_hote) 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.<br><br>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.<br><br>Les modèles doivent avoir la propriété `templateid` définie.|

[comment]: # ({/b5ea5d84-7b73358f})

[comment]: # ({ad896f91-d166b99b})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des hôtes mis à
jour sous la propriété `hostids`.

[comment]: # ({/ad896f91-d166b99b})

[comment]: # ({cbc0899d-b41637d2})
### Exmples

[comment]: # ({/cbc0899d-b41637d2})

[comment]: # ({f777ab4e-4a8d8b94})
#### Activation de plusieurs hôtes

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

Requête :

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

Réponse :

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

[comment]: # ({/f777ab4e-4a8d8b94})

[comment]: # ({38745247-4b09fb40})
### Voir également

-   [host.update](/fr/manual/api/reference/host/update)
-   [host.massadd](/fr/manual/api/reference/host/massadd)
-   [host.massremove](/fr/manual/api/reference/host/massremove)
-   [Modèle](/fr/manual/api/reference/template/object#modele)
-   [Groupe
    d'Hôte](/fr/manual/api/reference/hostgroup/object#groupe_d_hote)
-   [Macro
    utilisateur](/fr/manual/api/reference/usermacro/object#macro_d_hote)
-   [Interface
    hôte](/fr/manual/api/reference/hostinterface/object#interface_hote)

[comment]: # ({/38745247-4b09fb40})

[comment]: # ({773f8dde-83eada53})
### Source

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

[comment]: # ({/773f8dde-83eada53})