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

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

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

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

Ta metoda umożliwia aktualizację istniejących konserwacji.

::: noteclassic
Ta metoda jest dostępna tylko dla użytkowników typu *Admin* i *Super admin*. Uprawnienia do wywołania metody można odwołać w ustawieniach
roli użytkownika. Więcej informacji można znaleźć w [User
roles](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

[comment]: # ({07400e7c-678c22b3})
### Parametry

`(object/array)` Właściwości konserwacji do zaktualizowania.

Właściwość `maintenanceid` musi być zdefiniowana dla każdej konserwacji, wszystkie
pozostałe właściwości są opcjonalne. Zostaną zaktualizowane tylko przekazane właściwości,
wszystkie pozostałe pozostaną bez zmian.

Oprócz [standardowych właściwości konserwacji](object#maintenance) metoda akceptuje
następujące parametry.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|groups|object/array|[Grupy hostów](/manual/api/reference/hostgroup/object) do zastąpienia bieżących grup.<br><br>Grupy hostów mogą mieć zdefiniowaną tylko właściwość `groupid`.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *wymagany* jeśli `hosts` nie jest ustawiony|
|hosts|object/array|[Hosty](/manual/api/reference/host/object) do zastąpienia bieżących hostów.<br><br>Hosty mogą mieć zdefiniowaną tylko właściwość `hostid`.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *wymagany* jeśli `groups` nie jest ustawiony|
|timeperiods|object/array|[Okresy czasu](/manual/api/reference/maintenance/object#time-period) konserwacji do zastąpienia bieżących okresów.|
|tags|object/array|[Tagi problemów](/manual/api/reference/maintenance/object#problem-tag) do zastąpienia bieżących tagów.<br><br>[Zachowanie parametru](/manual/api/reference_commentary#parameter-behavior):<br>- *obsługiwany* jeśli `maintenance_type` obiektu [Maintenance object](object#maintenance) jest ustawiony na "with data collection"|
|groupids<br>(deprecated)|array|Ten parametr jest przestarzały, użyj zamiast niego `groups`.<br>Identyfikatory grup hostów, które zostaną objęte konserwacją.|
|hostids<br>(deprecated)|array|Ten parametr jest przestarzały, użyj zamiast niego `hosts`.<br>Identyfikatory hostów, które zostaną objęte konserwacją.|

[comment]: # ({/07400e7c-678c22b3})

[comment]: # ({b9ffa219-b9ffa219})
### Wartości zwracane

`(object)` Zwraca obiekt zawierający identyfikatory zaktualizowanych
konserwacji w ramach właściwości `maintenanceids`.

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

[comment]: # ({b41637d2-b41637d2})
### Przykłady

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

[comment]: # ({ffac6646-25215f8d})
#### Przypisywanie różnych hostów

Zastąp hosty aktualnie przypisane do konserwacji dwoma innymi.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({db5fcf06-82b3ef0e})
### Zobacz także

-   [Okres czasu](object#time-period)

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

[comment]: # ({63ad1661-63ad1661})
### Źródło

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

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