Table of Contents
service.update
Descrição
object service.update(object/array services)
Este método permite atualizar serviços existentes.
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 para obter mais informações.
Parâmetros
(object/array) propriedades do serviço a serem atualizadas.
A propriedade serviceid deve ser definida para cada serviço, todas as outras propriedades são opcionais. Somente as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.
Além das propriedades padrão do serviço, o método aceita os seguintes parâmetros.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| children | array | Serviços filhos para substituir os serviços filhos atuais. Os serviços filhos devem ter apenas a propriedade serviceid definida. |
| parents | array | Serviços pais para substituir os serviços pais atuais. Os serviços pais devem ter apenas a propriedade serviceid definida. |
| tags | array | Tags de serviço para substituir as tags de serviço atuais. |
| problem_tags | array | Tags de problema para substituir as tags de problema atuais. |
| status_rules | array | Regras de status para substituir as regras de status atuais. |
Valores de retorno
(object) Retorna um objeto contendo os IDs dos serviços atualizados na propriedade serviceids.
Exemplos
Definindo o pai para um serviço
Torne o serviço com ID "3" o pai do serviço com ID "5".
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"serviceid": "5",
"parents": [
{
"serviceid": "3"
}
]
},
"id": 1
}Resposta:
Adicionando um downtime agendado
Adicione um downtime para o serviço com ID "4" agendado semanalmente de segunda-feira 22:00 até terça-feira 10:00.
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"serviceid": "4",
"times": [
{
"type": "1",
"ts_from": "165600",
"ts_to": "201600"
}
]
},
"id": 1
}Resposta:
Fonte
CService::update() em ui/include/classes/api/services/CService.php.