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

(objeto/array) Propiedades de mantenimiento a actualizar.

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.

Parámetro	Tipo	Descripción
groups	objeto/array	Grupos de equipos para reemplazar los grupos actuales. Los grupos de equipos deben tener solo la propiedad `groupid` definida. Comportamiento del parámetro: - obligatorio si `hosts` no está establecido
hosts	objeto/array	Equipos para reemplazar los equipos actuales. Los equipos deben tener solo la propiedad `hostid` definida. Comportamiento del parámetro: - obligatorio si `groups` no está establecido
timeperiods	objeto/array	Periodos de tiempo de mantenimiento para reemplazar los periodos actuales.
tags	objeto/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
       }

Véase también

Período de tiempo

Fuente

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

Documentation