Documentation
Table of Contents
maintenance.create
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
object maintenance.create(object/array maintenances)
Este m¨¦todo permite crear nuevos mantenimientos.
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.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
(object/array) Maintenances to create.
Adem¨¢s del standard maintenanceproperties, el m¨¦todo acepta los siguientes par¨¢metros.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| groups | objeto/matriz | Host grupos que se someter¨¢ a mantenimiento. Los grupos de hosts deben tener la propiedad groupid definida.< br>Se debe especificar al menos un objeto de grupos o hosts. |
| hosts | objeto/matriz | Hosts que se someter¨¢n a mantenimiento. Los hosts deben tener la propiedad hostid definida.Se debe especificar al menos un objeto de grupos o hosts. |
| timeperiods (obligatorio) |
objeto/matriz | Mantenimiento time periods. |
| tags | objeto/matriz | Problem tags. Defina qu¨¦ problemas se deben suprimir. Si no se proporcionan etiquetas, se suprimir¨¢n todos los problemas del host de mantenimiento activo. |
| 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. |
Valores de retorno
(objeto) Devuelve un objeto que contiene los ID de los mantenimientos creados bajo la propiedad maintenanceids. El orden de los ID devueltos coinciden con el orden de los mantenimientos pasados.
Ejemplos
Creando un mantenimiento
Cree un mantenimiento con recopilaci¨®n de datos para el grupo de hosts con ID "2" y con etiquetas de problema servicio:mysqld y error. Debe estar activo desde 22.01.2013 al 22.01.2014, entra en vigor cada domingo a las 18:00 y el ¨²ltimo por una hora.
Solicitud:
{
"jsonrpc": "2.0",
"method": "maintenance.create",
"params": {
"name": "Sunday maintenance",
"active_since": 1358844540,
"active_till": 1390466940,
"tags_evaltype": 0,
"groups": [
{"groupid": "2"}
],
"timeperiods": [
{
"period": 3600,
"timeperiod_type": 3,
"start_time": 64800,
"every": 1,
"dayofweek": 64
}
],
"tags": [
{
"tag": "service",
"operator": "0",
"value": "mysqld"
},
{
"tag": "error",
"operator": "2",
"value": ""
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Respuesta:
Ver tambi¨¦n
Fuente
CMaintenance::create() enui/include/classes/api/services/CMaintenance.php.