Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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
       }

Response:

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

Fonte

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