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 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)
Mantenimientos a crear.
Además de llas propiedades de mantenimiento estándar, el método acepta los siguientes parámetros.
Parámetro | Tipo | Descripción |
---|---|---|
groups | objeto/matriz | Grupos de equipos que se someterán a mantenimiento. Los grupos de equipos deben tener la propiedad groupid definida.< br>Comportamiento de parámetros: - obligatorio si hosts no está configurado |
hosts | objeto/matriz | Equipos que se someterán a mantenimiento. Los equipos deben tener solo la propiedad hostid definida.<br >Comportamiento de parámetros: - obligatorio si grupos no está configurado |
timeperiods | objeto/matriz | Períodos de tiempo de mantenimiento. Comportamiento de parámetros: - obligatorio |
tags | objeto/matriz | Etiquetas de problema. Defina qué problemas se deben suprimir. Si no se proporcionan etiquetas, todas están activas se suprimirán los problemas del host de mantenimiento. 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. |
(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.
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 al 22.01.2014, entra en vigor cada domingo a las 18:00 durante 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:
CMaintenance::create() enui/include/classes/api/services/CMaintenance.php.