maintenance.update

Description

object maintenance.update(object/array maintenances)

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

Cette méthode est disponible uniquement pour les types d’utilisateurs Admin et Super admin. Les autorisations d’appel de la méthode peuvent être révoquées dans les paramètres des rôles utilisateur. Voir User roles 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 standard de maintenance, la méthode accepte les paramètres suivants.

Parameter Type Description
groups object/array Groupes d'hôtes à remplacer par les groupes actuels.

Les groupes d'hôtes doivent avoir uniquement la propriété groupid définie.

Comportement du paramètre:
- required si hosts n'est pas défini
hosts object/array Hôtes à remplacer par les hôtes actuels.

Les hôtes doivent avoir uniquement la propriété hostid définie.

Comportement du paramètre:
- required si groups n'est pas défini
timeperiods object/array Périodes de temps de maintenance à remplacer par les périodes actuelles.
tags object/array Balises de problème à remplacer par les balises actuelles.

Comportement du paramètre:
- supported si maintenance_type de l'objet Maintenance est défini sur "with data collection"
groupids
(deprecated)		 array Ce paramètre est obsolète, veuillez utiliser groups à la place.
Identifiants des groupes d'hôtes qui seront soumis à la maintenance.
hostids
(deprecated)		 array Ce paramètre est obsolète, veuillez utiliser hosts à la place.
Identifiants des hôtes qui seront soumis à la maintenance.

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.