maintenance.update

Description

object maintenance.update(object/array maintenances)

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

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 l'objet maintenance standard, la méthode accepte les paramètres suivants.

Paramètre	Type	Description
groupids	array	ID des groupes d'hôtes en remplacement les groupes actuels.
hostids	array	ID des hôtes en remplacement les hôtes actuels.
timeperiods	array	Périodes en remplacement les périodes actuelles.
tags	array	Tags de problème.

Au moins un hôte ou un 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. L'ordre des ID retournés correspond à l'ordre des maintenances transmies.

Exemples

Assigner différents hôtes

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

Requête :

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

Réponse :

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

Voir également

Période

Source

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

Documentation