Documentation
Table of Contents
maintenance.create
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
object maintenance.create(object/array maintenances)
Aquest m¨¨tode permet crear nous manteniments.
Tenim aquest m¨¨tode disponible nom¨¦s per als usuaris Admin i Super admin. Els permisos per cridar el m¨¨tode es poden revocar a la configuraci¨® dels rols d'usuari. Per a m¨¦s informaci¨®, veieu Rols d'usuari.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
(object/array) Manteniments a crear.
A m¨¦s de les [propietats de l'objecte de manteniment est¨¤ndard] (object#maintenance), el m¨¨tode accepta els par¨¤metres seg¨¹ents.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| groups | object/array | Grups d'equips que es sotmetran a manteniment. Els grups d'equips han de tindre la propietat groupid establerta .Comportament de la propietat: - obligatori si hosts no s'ha definit |
| hosts | object/array | Equip que es sotmetr¨¤ a manteniment. Els equips han de tindre la propietat hostid establerta.Comportament de la propietat: - obligatori si groups no s'ha establert |
| timeperiods | object/array | ±Ê±ð°ù¨ª´Ç»å±ðs de manteniment. Comportament de la propietat: - obligatori |
| tags | object/array | Etiquetes de problema. Defineix quins problemes s'han d'esborrar. Si no s'especifica cap etiqueta, s'esborraran tots els problemes de manteniment de l'equip actiu. Comportament de la propietat: - obligatori si maintenance_type de l'objecte de manteniment s'ha establert a "amb recollida de dades" |
| groupids (obsolet) |
array | Aquest par¨¤metre ¨¦s obsolet, si us plau, empreu groups. ID dels grups d'equips que es sotmetran a manteniment. |
| hostids (obsolet) |
array | Aquest par¨¤metre ¨¦s obsolet, si us plau, empreu hosts en lloc seu.ID dels equips que es sotmetran a manteniment. |
Valors de retorn
(object) Retorna un objecte amb els IDs dels manteniments creats segons la propietat maintenanceids. L'ordre dels IDs retornats correspon a l'ordre dels manteniments donats.
Exemples
Crear un manteniment
Crea un manteniment amb un recull de dades per al grup d'equips amb ID "2" i amb els tags de problema service:mysqld i error. Ha d'¨¦sser actiu des de 22.01.2013 fins a 22.01.2014, entrar en vigor cada diumenge a les 6 de la tarda i 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
}Resposta:
Veieu tamb¨¦
Font
CMaintenance::create() in ui/include/classes/api/services/CMaintenance.php.