maintenance.update
Description
object maintenance.update(object/array maintenances)
Cette méthode vous permet de mettre à jour les maintenances existantes.
Cette méthode est uniquement disponible pour les types d’utilisateurs Administrateur et Super administrateur. Les autorisations d’appeler cette méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Consultez la page Rôles utilisateur pour plus d’informations.
Paramètres
(object/array) Propriétés de maintenance à mettre à jour.
La propriété maintenanceid doit être définie pour chaque maintenance, toutes
les autres propriétés sont facultatives. Seules les propriétés transmises seront
mises à jour, toutes les autres resteront inchangées.
En plus des propriétés de maintenance standard, la méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| groups | object/array | Groupes d'hôtes pour remplacer les groupes actuels. Les groupes d'hôtes doivent avoir uniquement la propriété groupid définie.Comportement des paramètres : - obligatoire si hosts n'est pas défini |
| hosts | object/array | Hôtes pour remplacer les hôtes actuels. Les hôtes doivent avoir uniquement la propriété hostid définie.Comportement des paramètres : - obligatoire si groups n'est pas défini |
| timeperiods | object/array | Périodes de temps de maintenance pour remplacer les périodes actuelles. |
| tags | object/array | Balises de problème pour remplacer les balises actuelles. Comportement des paramètres : - pris en charge si maintenance_type de l'objet maintenance est défini sur "avec collecte de données" |
Valeurs retournées
(object) Retourne un objet contenant les identifiants des maintenances mises à jour sous la propriété maintenanceids.
Exemples
Attribution d’hôtes différents
Remplacez les hôtes actuellement attribués à la maintenance par deux autres.
Requête :
{
"jsonrpc": "2.0",
"method": "maintenance.update",
"params": {
"maintenanceid": "3",
"hosts": [
{"hostid": "10085"},
{"hostid": "10084"}
]
},
"id": 1
}Réponse :
{
"jsonrpc": "2.0",
"result": {
"maintenanceids": [
"3"
]
},
"id": 1
}Voir aussi
Source
CMaintenance::update() dans ui/include/classes/api/services/CMaintenance.php.