maintenance.update
Description
object maintenance.update(object/array maintenances)
Cette méthode vous permet de mettre à jour des maintenances existantes.
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 du rôle utilisateur. Consultez 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.
| Parameter | Type | Description |
|---|---|---|
| groups | object/array | Groupes d’hôtes qui remplaceront les groupes actuels. Les groupes d’hôtes doivent uniquement avoir la propriété groupid définie.Comportement du paramètre : - requis si hosts n’est pas défini |
| hosts | object/array | Hôtes qui remplaceront les hôtes actuels. Les hôtes doivent uniquement avoir la propriété hostid définie.Comportement du paramètre : - requis si groups n’est pas défini |
| triggers | object/array | Déclencheurs qui remplaceront les déclencheurs actuels. Les déclencheurs doivent uniquement avoir la propriété triggerid définie.Comportement du paramètre : - requis si groups et hosts ne sont pas définis- pris en charge si maintenance_type=0 (avec collecte des données) |
| event_names | object/array | Noms d’événements qui remplaceront les noms d’événements actuels. Comportement du paramètre : - pris en charge si maintenance_type=0 (avec collecte des données) |
| tags | object/array | Étiquettes de problème qui remplaceront les étiquettes actuelles. Comportement du paramètre : - pris en charge si maintenance_type de l’objet Maintenance est défini sur « avec collecte des données » |
| timeperiods | object/array | Périodes de maintenance qui remplaceront les périodes actuelles. |
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.