Documentation
Table of Contents
maintenance.update
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
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.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
(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.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| 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.
{
"jsonrpc": "2.0",
"method": "maintenance.update",
"params": {
"maintenanceid": "3",
"hosts": [
{"hostid": "10085"},
{"hostid": "10084"}
]
},
"id": 1
}Response:
Ver tambi¨¦n
Fuente
CMaintenance::update() enui/include/classes/api/services/CMaintenance.php.