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 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 del mantenimiento est¨¢ndar propiedades, el m¨¦todo acepta lo siguiente par¨¢metros.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| grupos | objeto/matriz | Grupos de hosts que se someter¨¢n a mantenimiento. Los grupos de hosts deben tener solo la propiedad groupid definida.Comportamiento de par¨¢metros: - obligatorio si hosts no est¨¢ configurado |
| hosts | objeto/matriz | Hosts que se someter¨¢n a mantenimiento. Los hosts deben tener solo la propiedad hostid definida.<br >Comportamiento de par¨¢metros: - obligatorio si grupos no est¨¢ configurado |
| timeperiods | object/array | Mantenimiento per¨ªodos de tiempo. Comportamiento de par¨¢metros: - obligatorio |
| tags | object/array | Etiquetas de problema. Defina qu¨¦ problemas se deben suprimir. Si no se proporcionan etiquetas, todas est¨¢n activas Los problemas de mantenimiento del host se suprimir¨¢n. 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 (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 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:
Ver tambi¨¦n
Fuente
CMaintenance::create() enui/include/classes/api/services/CMaintenance.php.