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

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

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

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

Questo metodo consente di aggiornare maintenance esistenti.

::: noteclassic
Questo metodo è disponibile solo per i tipi di utente *Admin* e *Super admin*.
I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente.
Per ulteriori informazioni, vedere [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Proprietà della manutenzione da aggiornare.

La proprietà `maintenanceid` deve essere definita per ogni manutenzione; tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, mentre tutte le altre rimarranno invariate.

Oltre alle [proprietà standard della manutenzione](object#maintenance), il metodo accetta i seguenti parametri.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|groups|object/array|[Host groups](/manual/api/reference/hostgroup/object) da sostituire ai gruppi correnti.<br><br>I gruppi host devono avere definita solo la proprietà `groupid`.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *required* se `hosts` non è impostato|
|hosts|object/array|[Hosts](/manual/api/reference/host/object) da sostituire agli host correnti.<br><br>Gli host devono avere definita solo la proprietà `hostid`.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *required* se `groups` non è impostato|
|timeperiods|object/array|[Periodi di tempo](/manual/api/reference/maintenance/object#time-period) della manutenzione da sostituire ai periodi correnti.|
|tags|object/array|[Tag del problema](/manual/api/reference/maintenance/object#problem-tag) da sostituire ai tag correnti.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* se `maintenance_type` dell'[oggetto Maintenance](object#maintenance) è impostato su "with data collection"|
|groupids<br>(deprecated)|array|Questo parametro è deprecato, usare invece `groups`.<br>ID dei gruppi host che saranno sottoposti a manutenzione.|
|hostids<br>(deprecated)|array|Questo parametro è deprecato, usare invece `hosts`.<br>ID degli host che saranno sottoposti a manutenzione.|

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

[comment]: # ({b9ffa219-b9ffa219})
### Valori restituiti

"(object)" Restituisce un oggetto contenente gli ID dell'oggetto aggiornato
manutenzioni sotto la proprietà `maintenanceids`.

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

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

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

[comment]: # ({ffac6646-25215f8d})
#### Assegnazione di host diversi

Sostituisci gli host attualmente assegnati alla manutenzione con altri due.

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

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

Risposta:

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

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

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

-   [Periodo di tempo](object#time-period)

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

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

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

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