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

Source

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