[comment]: # translation:outdated

[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]: # ({364d131c-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, 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|[Gruppi di host](/manual/api/reference/hostgroup/object) per sostituire i gruppi correnti.<br><br>I gruppi di host devono avere definita solo la proprietà `groupid`.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se `hosts` non è impostato|
|hosts|object/array|[Host](/manual/api/reference/host/object) per sostituire gli 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>- *obbligatorio* se `groups` non è impostato|
|timeperiods|object/array|[Periodi temporali](/manual/api/reference/maintenance/object#time-period) della manutenzione per sostituire i periodi correnti.|
|tags|object/array|[Tag dei problemi](/manual/api/reference/maintenance/object#problem-tag) per sostituire i tag correnti.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se `maintenance_type` dell'[oggetto manutenzione](object#maintenance) è impostato su "with data collection"|

[comment]: # ({/364d131c-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})