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) Onderhoud om aan te maken.
Naast de standaard eigenschappen voor onderhoud, accepteert de methode de volgende parameters.
| Parameter | Type | Beschrijving |
|---|---|---|
| groups | object/array | Host groepen die onder onderhoud zullen worden geplaatst. De hostgroepen moeten de eigenschap groupid gedefinieerd hebben.Er moet ten minste één object van groups of hosts worden opgegeven. |
| hosts | object/array | Hosts die onder onderhoud zullen worden geplaatst. De hosts moeten de eigenschap hostid gedefinieerd hebben.Er moet ten minste één object van groups of hosts worden opgegeven. |
| timeperiods (verplicht) |
object/array | Onderhoud tijdperiodes. |
| tags | object/array | Probleemtags. Definieer welke problemen moeten worden onderdrukt. Als er geen tags worden opgegeven, zullen alle actieve hostproblemen tijdens het onderhoud worden onderdrukt. |
| groupids (verouderd) |
array | Deze parameter is verouderd, gebruik in plaats daarvan groups.ID's van de hostgroepen die onder onderhoud zullen worden geplaatst. |
| hostids (verouderd) |
array | Deze parameter is verouderd, gebruik in plaats daarvan hosts.ID's van de hosts die onder onderhoud zullen worden geplaatst. |
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 een onderhoud met gegevensverzameling voor hostgroep met ID "2" en met probleemtags service:mysqld en fout. Het moet actief zijn vanaf 22.01.2013 tot 22.01.2014, van kracht elke zondag om 18:00 en laatste voor een uur.
Verzoek:
{
"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": ""
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Antwoord:
Zie ook
Bron
COnderhoud::create() in ui/include/classes/api/services/CMaintenance.php.