Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

maintenance.update

Descripción

object maintenance.update(object/array maintenances)

Este método permite actualizar los mantenimientos existentes.

Este método solo está disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Ver Roles de usuario para más información.

Parámetros

(objeto/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 proporcionadas, 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 definida solo la propiedad groupid.

Comportamiento del parámetro:
- obligatorio si hosts no está definido
hosts objeto/array Equipos para reemplazar los equipos actuales.

Los equipos deben tener definida solo la propiedad hostid.

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

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

Valores devueltos

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

Ejemplos

Asignación de diferentes anfitriones

Reemplazar los hosts actualmente asignados a mantenimiento por dos diferentes.

Solicitud:

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

Response:

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

Ver también

-Periodo de tiempo

Fuente

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