service.update

Descrição

object service.update(object/array services)

Este método permite atualizar os 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.

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, o método aceita os seguintes parâmetros.

Parâmetro	Tipo	Descrição
children	array	Serviços filho para substituir os serviços filhos do serviço atual. Os serviços filhos devem ter a propriedade `serviceid` definida.
parents	array	Serviços pai para substituir os pais de serviço atuais. Os pais devem ter a propriedade `serviceid` definida.
tags	array	Etiquetas de serviço para substituir as etiquetas de serviço atuais.
problem_tags	array	Etiquetas de problema para substituir as etiquetas 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

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:

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

Response:

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

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:

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