Sidebar

fr:manual:api:reference:maintenance:update

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

Source

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