Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

service.update

Descripción

object service.update(object/array services)

Este método permite actualizar servicios existentes.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte Roles de usuario para más información.

Parámetros

(objeto/array) propiedades del servicio a actualizar.

La propiedad serviceid debe estar definida para cada servicio, todas las demás propiedades son opcionales. Solo se actualizarán las propiedades enviadas, todas las demás permanecerán sin cambios.

Además de las propiedades estándar del servicio, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
children array Servicios hijos para reemplazar los servicios hijos actuales.

Los servicios hijos deben tener definida únicamente la propiedad serviceid.
parents array Servicios padres para reemplazar los servicios padres actuales.

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

Valores de retorno

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

Ejemplos

Establecer el padre para un servicio

Hacer que el servicio con ID "3" sea el padre 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
       }

Añadir un tiempo de inactividad programado

Añadir un tiempo de inactividad para el servicio con ID "4" programado semanalmente desde el 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
       }

Origen

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