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/matriz) Propiedades de mantenimiento que se actualizarán.

La propiedad maintenanceid debe definirse para cada mantenimiento, todos otras propiedades son opcionales. Sólo las propiedades pasadas serán actualizado, todos los demás permanecerán sin cambios.

Además del mantenimiento estándar propiedades, el método acepta lo siguiente parámetros.

Parámetro	Tipo	Descripción
groups	object/array	Grupos de hosts para reemplazar los grupos actuales. Los grupos de hosts deben tener solo la propiedad `groupid` definida.<br > Comportamiento de parámetros: - obligatorio si `hosts` no está configurado
hosts	object/array	Hosts para reemplazar los hosts actuales. Los hosts deben tener solo la propiedad `hostid` definida. < br>Comportamiento de parámetros: - obligatorio si `grupos` no está configurado
timeperiods	object/array	Mantenimiento time periods para reemplazar los períodos actuales.
tags	object/array	Etiquetas de problema para reemplazar las etiquetas actuales. Comportamiento de parámetros: - compatible si `maintenance_type` de objeto de mantenimiento está configurado en "con recopilación de datos"
groupids (obsoleto)	array	Este parámetro está obsoleto; utilice `groups` en su lugar. ID de los grupos de hosts que se someterán a mantenimiento.
hostids (deprecated)	array	Este parámetro está en desuso, utilice `hosts` en su lugar. ID de los hosts que se someterán a mantenimiento.

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.

Documentation