maintenance.create
Description
object maintenance.create(object/array maintenances)
Cette méthode permet de créer de nouvelles maintenances.
Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations pour appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir Rôles Utilisateur pour plus d'informations.
Paramètres
(object/array) Maintenances à créer.
En plus des propriétés standard de maintenance, la méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| groups | object/array | Groupes d'hôtes qui seront soumis à la maintenance. Les groupes d'hôtes doivent avoir uniquement la propriété groupid définie.Comportement du paramètre : - requis si hosts n'est pas défini |
| hosts | object/array | Hôtes qui seront soumis à la maintenance. Les hôtes doivent avoir uniquement la propriété hostid définie.Comportement du paramètre : - requis si groups n'est pas défini |
| timeperiods | object/array | Périodes temporelles de maintenance. Comportement du paramètre : - requis |
| tags | object/array | Balises de problème. Définissent quels problèmes doivent être supprimés. Si aucune balise n'est fournie, tous les problèmes d'hôte en maintenance active seront supprimés. Comportement du paramètre : - pris en charge si maintenance_type de l'objet Maintenance est défini sur "with data collection" |
| groupids (deprecated) |
array | Ce paramètre est obsolète, veuillez utiliser groups à la place.IDs des groupes d'hôtes qui seront soumis à la maintenance. |
| hostids (deprecated) |
array | Ce paramètre est obsolète, veuillez utiliser hosts à la place.IDs des hôtes qui seront soumis à la maintenance. |
Valeurs retournées
(object) Retourne un objet contenant les identifiants des maintenance créées sous la propriété maintenanceids. L'ordre des ID retournés correspond à l'ordre des maintenances transmises.
Exemples
Création d'une maintenance
Créez une maintenance avec collecte de données pour le groupe d'hôtes avec l'ID "2" et avec les tags de problème service:mysqld et error. Elle doit être active du 17.03.2026 au 17.03.2027, entrer en vigueur chaque dimanche à 18:00 et durer une heure.
{
"jsonrpc": "2.0",
"method": "maintenance.create",
"params": {
"name": "Sunday maintenance",
"active_since": 1773720240,
"active_till": 1805256240,
"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
}Réponse :
{
"jsonrpc": "2.0",
"result": {
"maintenanceids": [
"3"
]
},
"id": 1
}Voir aussi
Source
CMaintenance::create() dans ui/include/classes/api/services/CMaintenance.php.