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

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

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

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

Este método permite actualizar los servicios existentes.

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

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

[comment]: # ({74e0e89f-5fb5ebb3})
### Parámetros

Propiedades del servicio `(objeto/matriz)` que se actualizarán.

La propiedad `serviceid` debe definirse para cada servicio, todas las demás
propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas
las demás permanecerán sin cambios.

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

|Parámetro|[Tipo](/manual/api/reference_commentary#data_types)| Descripción|
|--|--|------|
|children|matriz|Servicios secundarios para reemplazar los servicios secundarios actuales.<br><br>Los niños deben tener definida la propiedad `serviceid`.|
|parents|matriz|Servicios principales para reemplazar los padres de servicio actuales.<br><br>Los padres deben tener definida la propiedad `serviceid`.|
|tags|matriz|[Etiquetas de servicio](/manual/api/reference/service/object#service_tag) para reemplazar las etiquetas de servicio actuales.|
|problem\_tags|matriz|[Etiquetas de problema](/manual/api/reference/service/object#problem_tag) para reemplazar las etiquetas de problema actuales.|
|status\_rules|matriz|[Reglas de estado](/manual/api/reference/service/object#status_rule) para reemplazar las reglas de estado actuales.|

[comment]: # ({/74e0e89f-5fb5ebb3})

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

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

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

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

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

[comment]: # ({3db3fe16-b9918036})
#### Configuración del servicio principal para un servicio

Haga que el servicio con ID "3" sea el servicio principal 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})
#### Agregar un tiempo de inactividad programado

Agregue un tiempo de inactividad para el servicio con ID "4" programado semanalmente a partir del 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})
### Fuente

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

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