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

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

[comment]: # ({79afe9b7-79afe9b7})
### Descrição  
  
`object service.update(object/array services)`  
  
Este método permite atualizar os serviços existentes.  
  
::: noteclassic  
Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte [Funções de usuário](/manual/web_interface/frontend_sections/administration/user_roles) para obter mais informações.
:::

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

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

`(object/array)` propriedades de serviço a serem atualizadas.

A propriedade `serviceid` deve ser definida para cada serviço, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.  
  
Além das [propriedades de serviço padrão](object#service), o método aceita os seguintes parâmetros.  
  
| Parâmetro | [Tipo](/manual/api/reference_commentary#data_types) | Descrição                                                                                                             |
|---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
| children      | array                                               | Serviços filho para substituir os serviços filhos do serviço atual.<br><br>Os serviços filhos devem ter a propriedade `serviceid` definida. |
| parents       | array                                               | Serviços pai para substituir os pais de serviço atuais.<br><br>Os pais devem ter a propriedade `serviceid` definida.  |
| tags          | array                                               | [Etiquetas](/manual/api/reference/service/object#service_tag) de serviço para substituir as etiquetas de serviço atuais.                   |
| problem\_tags | array                                               | [Etiquetas de problema](/manual/api/reference/service/object#problem_tag) para substituir as etiquetas de problema atuais.                   |
| status\_rules | array                                               | [Regras de status](/manual/api/reference/service/object#status_rule) para substituir as regras de status atuais.                   |

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

[comment]: # ({9465ee4d-9465ee4d})
### Valores de retorno  
  
`(object)` Retorna um objeto contendo os IDs dos serviços atualizados na propriedade `serviceids`.

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

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

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

[comment]: # ({2b175bc4-b9918036})
#### Configurando um  serviço pai para um serviço  
  
Faça o serviço com ID "3" ser o pai do serviço com ID "5".
Request:

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

Response:

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

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

[comment]: # ({7e5835e2-263b1baa})
#### Adicionando um tempo de inatividade programado  
  
Adicione um tempo de inatividade para serviço com ID "4" agendado semanalmente de segunda-feira às 22:00 até terça-feira às 10:00.
Request:

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

Response:

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

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

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

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

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