maintenance.update

Descripción

object maintenance.update(object/array maintenances)

Este método 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 ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para más información.

Parámetros

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

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

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

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

Los grupos de hosts deben tener definida solo la propiedad groupid.

Comportamiento del parámetro:
- requerido si hosts no está establecido
hosts object/array Hosts para reemplazar los hosts actuales.

Los hosts deben tener definida solo la propiedad hostid.

Comportamiento del parámetro:
- requerido si groups no está establecido
timeperiods object/array Períodos de tiempo de mantenimiento para reemplazar los períodos actuales.
tags object/array Etiquetas de problema para reemplazar las etiquetas actuales.

Comportamiento del parámetro:
- soportado si maintenance_type del objeto Maintenance está establecido en "con recolección de datos"

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.