Table of Contents
maintenance.create
Descripción
object maintenance.create(object/array maintenances)
Este método permite crear nuevos mantenimientos.
Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte Roles de usuario para más información.
Parámetros
(objeto/array) Mantenimientos a crear.
Además de las propiedades estándar de mantenimiento, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| groups | objeto/array | Grupos de equipos que estarán en mantenimiento. Los grupos de equipos deben tener definida únicamente la propiedad groupid.Comportamiento del parámetro: - obligatorio si hosts no está definido |
| hosts | objeto/array | Equipos que estarán en mantenimiento. Los equipos deben tener definida únicamente la propiedad hostid.Comportamiento del parámetro: - obligatorio si groups no está definido |
| timeperiods | objeto/array | Períodos de tiempo de mantenimiento. Comportamiento del parámetro: - obligatorio |
| tags | objeto/array | Etiquetas de problema. Defina qué problemas deben ser suprimidos. Si no se especifican etiquetas, se suprimirán todos los problemas activos de los equipos en mantenimiento. Comportamiento del parámetro: - soportado si maintenance_type del objeto Maintenance está establecido en "con recolección de datos" |
Valores de retorno
(object) Devuelve un objeto que contiene los IDs de los mantenimientos creados bajo la propiedad maintenanceids. El orden de los IDs devueltos coincide con el orden de los mantenimientos enviados.
Ejemplos
Creando un mantenimiento
Cree un mantenimiento con recopilación de datos para el grupo de equipos con ID "2" y con etiquetas de problema service:mysqld y error. Debe estar activo desde 22.01.2013 hasta 22.01.2014, entrar en vigor cada domingo a las 18:00 y durar una hora.
{
"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": ""
}
]
},
"id": 1
}Respuesta:
Véase también
Fuente
CMaintenance::create() en ui/include/classes/api/services/CMaintenance.php.