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

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

Los hijos deben tener definida la propiedad serviceid.
parents matriz Servicios principales para reemplazar los servicios principales actuales.

Los padres deben tener definida la propiedad serviceid.
tags matriz Servicio etiquetas 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"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "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.