Sidebar
fr:manual:api:reference:maintenance:create
Table of Contents
maintenance.create
Description
object maintenance.create(object/array maintenances)
Cette méthode permet de créer de nouvelles maintenances.
Paramètres
(object/array) Maintenances à créer.
En plus des propriétés de l'objet maintenance standard, la méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| groupids (obligatoire) | array | ID des groupes d'hôtes qui vont subir une maintenance. |
| hostids (obligatoire) | array | ID des hôtes qui vont subir une maintenance. |
| timeperiods (obligatoire) | array | Périodes. |
| tags | array | Tag de problème. Défini quels problèmes doivent être supprimés. Si aucun tag n’est spécifié, tous les problèmes d’hôte en maintenance actives seront supprimés. |
Au moins un hôte ou un groupe d’hôtes doit être défini pour chaque maintenance.
Valeurs retournées
(object) Retourne un objet contenant les identifiants des maintenances 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 “2” avec le tag de problème service:mysqld et error. Elle doit être active du 22.01.2013 au 22.01.2014, entrer en vigueur chaque dimanche à 18h00 et durer une heure.
Requête :
{ "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1358844540, "active_till": 1390466940, "tags_evaltype": 0, "groupids": [ "2" ], "timeperiods": [ { "timeperiod_type": 3, "every": 1, "dayofweek": 64, "start_time": 64800, "period": 3600 } ], "tags": [ { "tag": "service", "operator": "0", "value": "mysqld", }, { "tag": "error", "operator": "2", "value": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }
Réponse :
{ "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 }
Voir également
Source
CMaintenance::create() dans frontends/php/include/classes/api/services/CMaintenance.php.