maintenance.update

Descripción

object maintenance.update(object/array maintenances)

Este método le permite actualizar mantenimientos existentes.

Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden revocarse en la configuración de roles de usuario. Consulte User roles para obtener más información.

Parámetros

(object/array) Propiedades de mantenimiento que se actualizarán.

La propiedad maintenanceid debe definirse para cada mantenimiento; todas las demás propiedades son opcionales. Solo se actualizarán las propiedades pasadas; las demás permanecerán sin cambios.

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

Parámetro Tipo Descripción
groups object/array Grupos de hosts que reemplazarán los grupos actuales.

Los grupos de hosts deben tener definida únicamente la propiedad groupid.

Comportamiento del parámetro:
- obligatorio si no se establece hosts
hosts object/array Hosts que reemplazarán los hosts actuales.

Los hosts deben tener definida únicamente la propiedad hostid.

Comportamiento del parámetro:
- obligatorio si no se establece groups
triggers object/array Triggers que reemplazarán los triggers actuales.

Los triggers deben tener definida únicamente la propiedad triggerid.

Comportamiento del parámetro:
- obligatorio si no se establecen groups ni hosts
- compatible si maintenance_type=0 (con recopilación de datos)
event_names object/array Nombres de eventos que reemplazarán los nombres de eventos actuales.

Comportamiento del parámetro:
- compatible si maintenance_type=0 (con recopilación de datos)
tags object/array Etiquetas de problemas que reemplazarán las etiquetas actuales.

Comportamiento del parámetro:
- compatible si maintenance_type del objeto Maintenance está establecido en "con recopilación de datos"
timeperiods object/array Periodos de tiempo de mantenimiento que reemplazarán los periodos actuales.

Valores de retorno

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

Ejemplos

Asignar diferentes equipos

Reemplace los equipos actualmente asignados al mantenimiento por otros dos diferentes.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "maintenance.update",
    "params": {
        "maintenanceid": "3",
        "hosts": [
            {"hostid": "10085"},
            {"hostid": "10084"}
        ]
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "maintenanceids": [
            "3"
        ]
    },
    "id": 1
}

Ver también

Fuente

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