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

(object/array) propiedades del servicio a actualizar.

La propiedad serviceid debe estar definida 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 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 sólo deben tener definida la propiedad serviceid.
parents array Servicios padres para reemplazar los servicios padres actuales.

Los servicios padres sólo deben tener definida 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

(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.