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 definirse para cada mantenimiento; 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 de mantenimiento, el método acepta los siguientes parámetros.

Parameter Type Description
groups object/array Host groups que reemplazarán a los grupos actuales.

Los host groups deben tener definida solo la propiedad groupid.

Parameter behavior:
- required si hosts no está definido
hosts object/array Hosts que reemplazarán a los hosts actuales.

Los hosts deben tener definida solo la propiedad hostid.

Parameter behavior:
- required si groups no está definido
timeperiods object/array Períodos de tiempo de mantenimiento que reemplazarán a los períodos actuales.
tags object/array Etiquetas de problema que reemplazarán a las etiquetas actuales.

Parameter behavior:
- supported si maintenance_type del Maintenance object está establecido en "with data collection"
groupids
(deprecated)		 array Este parámetro está obsoleto; utilice groups en su lugar.
IDs de los host groups que entrarán en mantenimiento.
hostids
(deprecated)		 array Este parámetro está obsoleto; utilice hosts en su lugar.
IDs de los hosts que entrarán en mantenimiento.

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.