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, todos los demás Las propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas otros permanecerán sin cambios.

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

Parámetro Tipo Descripción
children array [servicios] secundarios(/manual/api/reference/service/object#service) para reemplazar los servicios secundarios actuales.

Los servicios secundarios deben tener solo la propiedad serviceid definida.
parents array [servicios] principales(/manual/api/reference/service/object#service) para reemplazar los servicios principales actuales.

Los servicios principales deben tener solo la propiedad serviceid definida.
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.