[comment]: # translation:outdated

[comment]: # ({cd4a930c-cd4a930c})
# service.update

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

[comment]: # ({5044bc6a-79afe9b7})
### Descrizione

`object service.update(object/array services)`

Questo metodo consente di aggiornare servizi esistenti.

::: noteclassic
Questo metodo è disponibile per utenti di qualsiasi tipo. I permessi
per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Vedere [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles)
per ulteriori informazioni.
:::

[comment]: # ({/5044bc6a-79afe9b7})

[comment]: # ({7f072363-5fb5ebb3})
### Parametri

`(object/array)` proprietà del servizio da aggiornare.

La proprietà `serviceid` deve essere definita per ciascun servizio, tutte le altre
proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, tutte
le altre rimarranno invariate.

Oltre alle [proprietà standard del servizio](object#service), il
metodo accetta i seguenti parametri.

|Parametro|[Type](/manual/api/reference_commentary#data-types)| Descrizione|
|--|--|------|
|children|array|[Servizi](/manual/api/reference/service/object#service) figli per sostituire gli attuali servizi figli.<br><br>I servizi figli devono avere definita solo la proprietà `serviceid`.|
|parents|array|[Servizi](/manual/api/reference/service/object#service) padre per sostituire gli attuali servizi padre.<br><br>I servizi padre devono avere definita solo la proprietà `serviceid`.|
|tags|array|[Tag del servizio](/manual/api/reference/service/object#service-tag) per sostituire gli attuali tag del servizio.|
|problem\_tags|array|[Tag del problema](/manual/api/reference/service/object#problem-tag) per sostituire gli attuali tag del problema.|
|status\_rules|array|[Regole di stato](/manual/api/reference/service/object#status-rule) per sostituire le attuali regole di stato.|

[comment]: # ({/7f072363-5fb5ebb3})

[comment]: # ({9465ee4d-9465ee4d})
### Valori di ritorno

`(object)` Restituisce un oggetto contenente gli ID dei servizi aggiornati
sotto la proprietà `serviceids`.

[comment]: # ({/9465ee4d-9465ee4d})

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

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

[comment]: # ({3db3fe16-b9918036})
#### Impostazione del parent per un servizio

Impostare il servizio con ID "3" come parent del servizio con ID "5".

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

```json
{
    "jsonrpc": "2.0",
    "method": "service.update",
    "params": {
        "serviceid": "5",
        "parents": [
            {
                "serviceid": "3"
            }
        ]
    },
    "id": 1
}
```

Risposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "serviceids": [
            "5"
        ]
    },
    "id": 1
}
```

[comment]: # ({/3db3fe16-b9918036})

[comment]: # ({96cfca7d-263b1baa})
#### Aggiunta di un periodo di inattività pianificato

Aggiungere un periodo di inattività per il servizio con ID "4", pianificato settimanalmente dal lunedì
alle 22:00 fino al martedì alle 10:00.

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

```json
{
    "jsonrpc": "2.0",
    "method": "service.update",
    "params": {
        "serviceid": "4",
        "times": [
            {
                "type": "1",
                "ts_from": "165600",
                "ts_to": "201600"
            }
        ]
    },
    "id": 1
}
```

Risposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "serviceids": [
            "4"
        ]
    },
    "id": 1
}
```

[comment]: # ({/96cfca7d-263b1baa})

[comment]: # ({fd1b6894-fd1b6894})
### Fonte

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

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