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

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

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

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

Este método permite actualizar servicios existentes.

::: noteclassic
Este método está disponible para usuarios de cualquier tipo. Los permisos
para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte [Roles de usuario](/manual/web_interface/frontend_sections/users/user_roles)
para más información.
:::

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

[comment]: # ({7f072363-5fb5ebb3})
### Parámetros

`(object/array)` propiedades del servicio a actualizar.

La propiedad `serviceid` debe estar definida para cada servicio, todas las demás propiedades son opcionales. Solo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.

Además de las [propiedades estándar del servicio](object#service), el método acepta los siguientes parámetros.

|Parámetro|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|children|array|[Servicios](/manual/api/reference/service/object#service) hijos para reemplazar los servicios hijos actuales.<br><br>Los servicios hijos solo deben tener definida la propiedad `serviceid`.|
|parents|array|[Servicios](/manual/api/reference/service/object#service) padres para reemplazar los servicios padres actuales.<br><br>Los servicios padres solo deben tener definida la propiedad `serviceid`.|
|tags|array|[Etiquetas de servicio](/manual/api/reference/service/object#service-tag) para reemplazar las etiquetas de servicio actuales.|
|problem\_tags|array|[Etiquetas de problema](/manual/api/reference/service/object#problem-tag) para reemplazar las etiquetas de problema actuales.|
|status\_rules|array|[Reglas de estado](/manual/api/reference/service/object#status-rule) para reemplazar las reglas de estado actuales.|

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

[comment]: # ({9465ee4d-9465ee4d})
### Valores de retorno

`(object)` Devuelve un objeto que contiene los IDs de los servicios actualizados
bajo la propiedad `serviceids`.

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

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

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

[comment]: # ({3db3fe16-b9918036})
#### Establecer el padre para un servicio

Hacer que el servicio con ID "3" sea el padre del servicio con ID "5".

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

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

Respuesta:

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

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

[comment]: # ({96cfca7d-263b1baa})
#### Añadir un tiempo de inactividad programado

Añadir un tiempo de inactividad para el servicio con ID "4" programado semanalmente desde el lunes
22:00 hasta el martes 10:00.

[Solicitud](/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
}
```

Respuesta:

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

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

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

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

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