Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

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, todas las otras propiedades son opcionales. Sólo las propiedades pasadas serán actualizadas, todas las demás permanecerán sin cambios.

Además de las propiedades de mantenimiento estándar, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
groups objeto/matriz Grupos de equipos para reemplazar los grupos actuales.

Los grupos de equipos deben tener la propiedad groupid definida.

Comportamiento de parámetros:
- obligatorio si hosts no está configurado
hosts objeto/matriz Equipos para reemplazar los equipos actuales.

Los equipos deben tener solo la propiedad hostid definida.
< br>Comportamiento de parámetros:
- obligatorio si grupos no está configurado
timeperiods objeto/matriz Periodos de tiempo de mantenimiento para reemplazar los períodos actuales.
tags objeto/matriz 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)
matriz Este parámetro está obsoleto; utilice groups en su lugar.
ID de los grupos de equipos que se someterán a mantenimiento.
hostids
(obsoleto)
matriz Este parámetro está obsoleto; utilice hosts en su lugar.
ID de los equipos 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.