[comment]: # translation:outdated

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

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

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

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

Diese Methode ermöglicht die Aktualisierung bestehender Wartungen.

::: noteclassic
Diese Methode ist nur für die Benutzertypen *Admin* und *Super admin*
verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den
Benutzerrolleneinstellungen entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Zu aktualisierende Wartungseigenschaften.

Die Eigenschaft `maintenanceid` muss für jede Wartung definiert sein, alle
anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden
aktualisiert, alle anderen bleiben unverändert.

Zusätzlich zu den [Standard-Wartungseigenschaften](object#maintenance)
akzeptiert die Methode die folgenden Parameter.

|Parameter|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|groups|object/array|[Host-Gruppen](/manual/api/reference/hostgroup/object), die die aktuellen Gruppen ersetzen.<br><br>Für die Host-Gruppen darf nur die Eigenschaft `groupid` definiert sein.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*, wenn `hosts` nicht gesetzt ist|
|hosts|object/array|[Hosts](/manual/api/reference/host/object), die die aktuellen Hosts ersetzen.<br><br>Für die Hosts darf nur die Eigenschaft `hostid` definiert sein.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *erforderlich*, wenn `groups` nicht gesetzt ist|
|timeperiods|object/array|Wartungs-[Zeitperioden](/manual/api/reference/maintenance/object#time-period), die die aktuellen Zeiträume ersetzen.|
|tags|object/array|[Problem-Tags](/manual/api/reference/maintenance/object#problem-tag), die die aktuellen Tags ersetzen.<br><br>[Parameterverhalten](/manual/api/reference_commentary#parameter-behavior):<br>- *unterstützt*, wenn `maintenance_type` des [Wartungsobjekts](object#maintenance) auf „with data collection“ gesetzt ist|

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

[comment]: # ({b9ffa219-b9ffa219})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der aktualisierten
Wartung unter der Eigenschaft `maintenanceids` enthält.

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

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

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

[comment]: # ({ffac6646-25215f8d})
#### Zuweisen verschiedener Hosts

Ersetzen Sie die Hosts, die derzeit der Wartung zugewiesen sind, durch zwei andere.

[Anfrage](/manual/api#performing-requests):

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

Antwort:

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

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

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

-   [Zeitperiode](object#time-period)

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

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

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

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