Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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) Onderhouden om aan te maken.

Naast het standaard onderhoud eigenschappen, accepteert de methode het volgende: parameters.

Parameter Type Beschrijving
groups object/array Host groups die onderhoud zal ondergaan.

De hostgroepen moeten de eigenschap groupid hebben gedefinieerd.
< br>Minstens één object van groups of hosts moet worden gespecificeerd.
hosts object/array Hosts die onderhoud zullen ondergaan.

De hosts moeten de eigenschap hostid hebben gedefinieerd.

Er moet ten minste één object van groups of hosts worden opgegeven.
timeperiods
(vereist)
object/array Onderhoud timeperiods.
tags object/array Probleemtags.

Definieer welke problemen moeten worden onderdrukt.
Als er geen tags zijn opgegeven, zijn ze allemaal actief problemen met onderhoudshosts worden onderdrukt.

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:

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

Zie ook

Bron

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