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 activar el método se pueden revocar en la configuración del rol de usuario. Ver User roles para más información.

Parámetros

(object/array) Maintenance properties to be updated.

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

Además del standard maintenanceproperties, el método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
groups	objeto/matriz	Hospeda groups para reemplazar los grupos actuales. Los grupos de host deben tener la propiedad `groupid` definida.
hosts	objeto/matriz	Hosts para reemplazar los hosts actuales. Los hosts deben tener la propiedad `hostid` definida.
timeperiods	objeto/matriz	Mantenimiento time periods para reemplazar los períodos actuales.
tags	objeto/matriz	Problem tags para reemplazar las etiquetas actuales.
groupids (obsoleto)	matriz	Este parámetro está obsoleto; utilice `groups` en su lugar. ID de los grupos de hosts que se someterán a mantenimiento.
hostids (obsoleto)	matriz	Este parámetro está obsoleto; utilice `hosts` en su lugar. ID de los hosts que se someterán a mantenimiento.

Se debe definir al menos un host o grupo de hosts para cada mantenimiento.

Valores devueltos

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

Ejemplos

Asignación de diferentes hosts

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"}
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

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

Ver también

-Time period

Fuente

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

Documentation