Wartungs-Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der maintenance API.

Wartung

Das Wartungsobjekt hat die folgenden Eigenschaften.

Property Type Description
maintenanceid ID ID der Wartung.

Property behavior:
- schreibgeschützt
- erforderlich für Aktualisierungsoperationen
name string Name der Wartung.

Property behavior:
- erforderlich für Erstellungsoperationen
active_since timestamp Zeitpunkt, ab dem die Wartung aktiv wird (einschließlich).

Der angegebene Wert wird auf Minuten abgerundet.

Property behavior:
- erforderlich für Erstellungsoperationen
active_till timestamp Zeitpunkt, bis zu dem die Wartung aktiv ist (ausschließlich).

Der angegebene Wert wird auf Minuten abgerundet.

Property behavior:
- erforderlich für Erstellungsoperationen
description string Beschreibung der Wartung.
maintenance_type integer Typ der Wartung.

Mögliche Werte:
0 - (Standard) mit Datenerfassung;
1 - ohne Datenerfassung.
tags_evaltype integer Problem-Tag Auswertungsmethode.

Mögliche Werte:
0 - (Standard) Und/Oder;
2 - Oder.

Zeitperiode

Das Objekt für die Zeitperiode wird verwendet, um Zeiträume zu definieren, in denen die Wartung wirksam werden muss. Es hat die folgenden Eigenschaften.

Eigenschaft Type Beschreibung
period integer Dauer des Wartungszeitraums in Sekunden.

Der angegebene Wert wird auf Minuten abgerundet.

Mögliche Werte: 300 - 86399940.

Standard: 3600.
timeperiod_type integer Typ der Zeitperiode.

Mögliche Werte:
0 - (Standard) nur einmal;
2 - täglich;
3 - wöchentlich;
4 - monatlich.
start_date timestamp Datum, an dem der Wartungszeitraum wirksam werden muss.
Der angegebene Wert wird auf Minuten abgerundet.

Standard: aktuelles Datum.

Property behavior:
- unterstützt, wenn timeperiod_type auf "nur einmal" gesetzt ist
start_time integer Uhrzeit des Tages, zu der die Wartung beginnt, in Sekunden.
Der angegebene Wert wird auf Minuten abgerundet.

Standard: 0.

Property behavior:
- unterstützt, wenn timeperiod_type auf "täglich", "wöchentlich" oder "monatlich" gesetzt ist
every integer Für tägliche und wöchentliche Zeiträume definiert every die Tages- oder Wochenintervalle, in denen die Wartung wirksam werden muss.
Standardwert, wenn timeperiod_type auf "täglich" oder "wöchentlich" gesetzt ist: 1.

Für monatliche Zeiträume, wenn day gesetzt ist, definiert die Eigenschaft every den Tag des Monats, an dem die Wartung wirksam werden muss.
Standardwert, wenn timeperiod_type auf "monatlich" gesetzt ist und day gesetzt ist: 1.

Für monatliche Zeiträume, wenn dayofweek gesetzt ist, definiert die Eigenschaft every die Woche des Monats, in der die Wartung wirksam werden muss.
Mögliche Werte, wenn timeperiod_type auf "monatlich" gesetzt ist und dayofweek gesetzt ist:
1 - (Standard) erste Woche;
2 - zweite Woche;
3 - dritte Woche;
4 - vierte Woche;
5 - letzte Woche.

Property behavior:
- unterstützt, wenn timeperiod_type auf "täglich", "wöchentlich" oder "monatlich" gesetzt ist
dayofweek integer Wochentage, an denen die Wartung wirksam werden muss.

Mögliche Bitmap-Werte:
1 - Montag;
2 - Dienstag;
4 - Mittwoch;
8 - Donnerstag;
16 - Freitag;
32 - Samstag;
64 - Sonntag.

Dies ist ein Bitmaskenfeld; jede Summe der möglichen Bitmap-Werte ist zulässig (zum Beispiel 21 für Montag, Mittwoch und Freitag).

Property behavior:
- erforderlich, wenn timeperiod_type auf "wöchentlich" gesetzt ist oder wenn timeperiod_type auf "monatlich" gesetzt ist und day nicht gesetzt ist
day integer Tag des Monats, an dem die Wartung wirksam werden muss.

Property behavior:
- erforderlich, wenn timeperiod_type auf "monatlich" gesetzt ist und dayofweek nicht gesetzt ist
month integer Monate, in denen die Wartung wirksam werden muss.

Mögliche Bitmap-Werte:
1 - Januar;
2 - Februar;
4 - März;
8 - April;
16 - Mai;
32 - Juni;
64 - Juli;
128 - August;
256 - September;
512 - Oktober;
1024 - November;
2048 - Dezember.

Dies ist ein Bitmaskenfeld; jede Summe der möglichen Bitmap-Werte ist zulässig (zum Beispiel 585 für Januar, April, Juli und Oktober).

Property behavior:
- erforderlich, wenn timeperiod_type auf "monatlich" gesetzt ist

Problem-Tag

Das Problem-Tag-Objekt wird verwendet, um festzulegen, welche Probleme unterdrückt werden müssen, wenn die Wartung wirksam wird. Tags können nur angegeben werden, wenn maintenance_type des Wartungsobjekts auf "with data collection" gesetzt ist. Es hat die folgenden Eigenschaften.

Property Type Description
tag string Name des Problem-Tags.

Property behavior:
- required
operator integer Bedingungs-operator.

Mögliche Werte:
0 - Gleich;
2 - (default) Enthält.
value string Wert des Problem-Tags.