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 de plusieurs hôtes.
Cette méthode est disponible uniquement pour les types d'utilisateur Admin et Super admin. Les autorisations d'appel de la méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Voir Rôles utilisateur pour plus d'informations.
Paramètres
(object) Paramètres contenant les IDs des hôtes à mettre à jour et les propriétés qui doivent être mises à jour.
En plus des propriétés standard de l'hôte, la méthode accepte les paramètres suivants.
| Parameter | Type | Description |
|---|---|---|
| hosts | object/array | Hôtes à mettre à jour. Les hôtes doivent avoir uniquement la propriété hostid définie.Comportement du paramètre: - required |
| groups | object/array | Groupes d'hôtes à remplacer pour les groupes d'hôtes actuels auxquels les hôtes appartiennent. Les groupes d'hôtes doivent avoir uniquement la propriété groupid définie. |
| interfaces | object/array | Interfaces d'hôte à remplacer pour les interfaces d'hôte actuelles sur les hôtes donnés. |
| inventory | object | Propriétés de l'inventaire de l'hôte. Le mode d'inventaire de l'hôte ne peut pas être mis à jour à l'aide du paramètre inventory, utilisez inventory_mode à la place. |
| macros | object/array | Macros utilisateur à remplacer pour les macros utilisateur actuelles sur les hôtes donnés. |
| templates | object/array | Modèles à lier à la place des modèles actuellement liés sur les hôtes donnés. Les modèles doivent avoir uniquement la propriété templateid définie. |
| templates_clear | object/array | Modèles à délier et à supprimer des hôtes donnés. Les modèles doivent avoir uniquement 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
Activez la surveillance de deux hôtes, c'est-à-dire définissez leur statut sur "0".
Request :
{
"jsonrpc": "2.0",
"method": "host.massupdate",
"params": {
"hosts": [
{
"hostid": "69665"
},
{
"hostid": "69666"
}
],
"status": 0
},
"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.