Documentation
Table of Contents
maintenance.create
Beschrijving
object onderhoud.create(object/array onderhoud)
Deze methode maakt het mogelijk om nieuwe onderhoudsbeurten te creëren.
Deze methode is alleen beschikbaar voor Admin en Super admin gebruikers typen. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol instellingen. Zie Gebruiker rollen voor meer informatie.
Parameters
(object/array) Onderhoudsinstellingen om aan te maken.
Naast de standaard eigenschappen voor onderhoud, accepteert deze methode de volgende parameters:
| Parameter | Type | Beschrijving |
|---|---|---|
| groups | object/array | Host groepen die onderhoud zullen ondergaan. De hostgroepen moeten de eigenschap groupid hebben gedefinieerd.Gedrag van de parameter: - vereist als hosts niet is ingesteld |
| hosts | object/array | Hosts die onderhoud zullen ondergaan. De hosts moeten alleen de eigenschap hostid hebben gedefinieerd.Gedrag van de parameter: - vereist als groups niet is ingesteld |
| timeperiods | object/array>Onderhoud tijdsperiodes. Gedrag van de parameter: - vereist |
|
| tags | object/array | Probleemtags. Definieer welke problemen moeten worden onderdrukt. Als er geen tags worden opgegeven, worden alle actieve onderhoudshostproblemen onderdrukt. Gedrag van de parameter: - ondersteund als maintenance_type van onderhoudsobject is ingesteld op "met gegevensverzameling" |
| groupids (verouderd) |
array | Deze parameter is verouderd, gebruik groups in plaats daarvan.IDs van de hostgroepen die onderhoud zullen ondergaan. |
| hostids (verouderd) |
array | Deze parameter is verouderd, gebruik hosts in plaats daarvan.IDs van de hosts die onderhoud zullen ondergaan. |
Retourwaarden
(object) Retourneert een object met de ID's van de gemaakte onderhoud onder de eigenschap maintenanceids. De volgorde van de geretourneerde ID's komen overeen met de volgorde van de uitgevoerde onderhoudsbeurten.
Voorbeelden
Onderhoud aanmaken
Maak onderhoud met gegevensverzameling aan voor hostgroep met ID "2" en met probleemtags service:mysqld en error. Het moet actief zijn vanaf 22.01.2013 tot 22.01.2014, elke zondag om 18:00 ingaan en één uur duren.
{
"jsonrpc": "2.0",
"method": "maintenance.create",
"params": {
"name": "Zondag onderhoud",
"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
}Reactie:
Zie ook
Bron
COnderhoud::create() in ui/include/classes/api/services/CMaintenance.php.