[comment]: # translation:outdated

[comment]: # ({8c711e69-8c711e69})
# maintenance.update

[comment]: # ({/8c711e69-8c711e69})

[comment]: # ({e3d076ea-292dcffa})
### Description

`object maintenance.update(object/array maintenances)`

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

::: noteclassic
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](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d’informations.
:::

[comment]: # ({/e3d076ea-292dcffa})

[comment]: # ({364d131c-678c22b3})
### 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](object#maintenance), la méthode accepte les
paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|groups|object/array|[Groupes d'hôtes](/manual/api/reference/hostgroup/object) pour remplacer les groupes actuels.<br><br>Les groupes d'hôtes doivent avoir uniquement la propriété `groupid` définie.<br><br>[Comportement des paramètres](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* si `hosts` n'est pas défini|
|hosts|object/array|[Hôtes](/manual/api/reference/host/object) pour remplacer les hôtes actuels.<br><br>Les hôtes doivent avoir uniquement la propriété `hostid` définie.<br><br>[Comportement des paramètres](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatoire* si `groups` n'est pas défini|
|timeperiods|object/array|[Périodes de temps](/manual/api/reference/maintenance/object#time-period) de maintenance pour remplacer les périodes actuelles.|
|tags|object/array|[Balises de problème](/manual/api/reference/maintenance/object#problem-tag) pour remplacer les balises actuelles.<br><br>[Comportement des paramètres](/manual/api/reference_commentary#parameter-behavior) :<br>- *pris en charge* si `maintenance_type` de l'[objet maintenance](object#maintenance) est défini sur "avec collecte de données"|

[comment]: # ({/364d131c-678c22b3})

[comment]: # ({b9ffa219-b9ffa219})
### Valeurs retournées

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

[comment]: # ({/b9ffa219-b9ffa219})

[comment]: # ({b41637d2-b41637d2})
### Exemples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({ffac6646-25215f8d})
#### Attribution d’hôtes différents

Remplacez les hôtes actuellement attribués à la maintenance par deux autres.

[Requête](/manual/api#performing-requests) :

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

Réponse :

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

[comment]: # ({/ffac6646-25215f8d})

[comment]: # ({db5fcf06-82b3ef0e})
### Voir aussi

-   [Période de temps](object#time-period)

[comment]: # ({/db5fcf06-82b3ef0e})

[comment]: # ({63ad1661-63ad1661})
### Source

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

[comment]: # ({/63ad1661-63ad1661})