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

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

[comment]: # ({79afe9b7-79afe9b7})
### Descripció

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

Aquest mètode permet actualitzar serveis existents.

::: noteclassic
Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles).
:::

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

[comment]: # ({4ccd379d-4ccd379d})
### Paràmetres

Les propietats del servei `(object/array)` s'han d'actualitzar.

La propietat `serviceid` s'ha d'establir per a cada servei, totes les altres propietats són opcionals. Només s'actualitzaran les propietats anteriors, les altres romandran sense canvis.

A més de les [propietats del servei estàndard](object#service), el mètode admet els paràmetres següents.

| Paràmetre | [Tipus](/manual/api/reference_commentary#data_types) | Descripció |
|----------------|---------------------------------- ---------------------------------|------------------ --------------------- ----------------------------- --------------------- ----------------------------- --------------|
| children | array | Serveis fill per substituir els serveis fill actuals.<br><br>Els serveis han de tindre la propietat `serviceid` establerta. |
| parents | array | Serveis pare per substituir els serveis pare actuals.<br><br>Els serveis han de tindre la propietat `serviceid` establerta. |
| tags | array | [Etiquetes de servei](/manual/api/reference/service/object#service_tag) substituint les etiquetes de servei actuals. |
| problem\_tags | array | [Etiquetes de problema](/manual/api/reference/service/object#problem_tag) substituint les etiquetes de problema actuals. |
| status\_rules | array | [Regles d'estat](/manual/api/reference/service/object#status_rule) que substitueixen les regles d'estat actual. |

[comment]: # ({/4ccd379d-4ccd379d})

[comment]: # ({9465ee4d-9465ee4d})
### Valors de retorn

`(object)` Retorna un objecte contingut als IDs dels serveis actualitzats sota la propietat `serviceids`.

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

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

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

[comment]: # ({2b175bc4-b9918036})
#### Configurar el pare d'un servei

Fer que el sevei amb l'ID "3" sigui el pare del servei amb l'ID "5".

Petició:

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

Resposta:

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

[comment]: # ({/2b175bc4-b9918036})

[comment]: # ({7e5835e2-263b1baa})
#### Afegir un temps d'aturada planificat

Afegir un temps d'aturada per al servei amb l'ID "4", programat cada setmana de dilluns a les 10 del vespre a dimarts a les 10 del matí.

Petició:

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

Resposta:

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

[comment]: # ({/7e5835e2-263b1baa})

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

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

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