maintenance.update

Description

object maintenance.update(object/array maintenances)

Cette méthode permet de mettre à jour les maintenances existantes.

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.

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 en remplacement des groupes actuels. Les groupes d'hôtes doivent avoir la propriété `groupid` définie.
hosts	object/array	Hôtes en remplacement de hôtes actuels. Les hôtes doivent avoir la propriété `hostid` définie.
timeperiods	object/array	Périodes de maintenance en remplacement des périodes actuelles.
tags	object/array	Tags de problème en remplacement des tags actuels.
groupids (obsolète)	array	Ce paramètre est obsolète, veuillez utiliser des `groups` à la place. ID des groupes d'hôte qui subiront la maintenance.
hostids (obsolète)	array	Ce paramètre est obsolète, veuillez utiliser des `hosts` à la place. IDs des hôtes qui subiront la maintenance.

Au moins un hôte ou groupe d'hôtes doit être défini pour chaque maintenance.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des maintenances mises à jour sous la propriété maintenanceids.

Exemples

Attribuer différents hôtes

Remplacez les hôtes actuellement affectés à la maintenance par deux hôtes différents.

Requête :

{
           "jsonrpc": "2.0",
           "method": "maintenance.update",
           "params": {
               "maintenanceid": "3",
               "hosts": [
                   {"hostid": "10085"},
                   {"hostid": "10084"}
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": {
               "maintenanceids": [
                   "3"
               ]
           },
           "id": 1
       }

Voir également

Période

Source

CMaintenance::update() dans ui/include/classes/api/services/CMaintenance.php.

Documentation