This is a translation of the original English documentation page. Help us make it better.

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.

Verzoek:

{
           "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:

{
           "jsonrpc": "2.0",
           "result": {
               "maintenanceids": [
                   "3"
               ]
           },
           "id": 1
       }

Zie ook

Bron

COnderhoud::create() in ui/include/classes/api/services/CMaintenance.php.