Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

service.update

Descripción

object service.update(object/array services)

Este método permite actualizar los servicios existentes.

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 para obtener más información.

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, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
children matriz Servicios secundarios para reemplazar los servicios secundarios actuales.

Los niños deben tener definida la propiedad serviceid.
parents matriz Servicios principales para reemplazar los padres de servicio actuales.

Los padres deben tener definida la propiedad serviceid.
tags matriz Etiquetas de servicio para reemplazar las etiquetas de servicio actuales.
problem_tags matriz Etiquetas de problema para reemplazar las etiquetas de problema actuales.
status_rules matriz Reglas de estado para reemplazar las reglas de estado actuales.

Valores de retorno

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

Ejemplos

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:

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

Respuesta:

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

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:

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

Respuesta:

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

Fuente

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