Wartungs-Objekt

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

Wartung

Das Wartungsobjekt hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
maintenanceid ID ID der Wartung.

Verhalten der Eigenschaft:
- schreibgeschützt
- erforderlich für Aktualisierungsvorgänge
name string Name der Wartung.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
active_since timestamp Zeitpunkt, zu dem die Wartung aktiv wird (einschließlich).

Der angegebene Wert wird auf Minuten abgerundet.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
active_till timestamp Zeitpunkt, zu dem die Wartung nicht mehr aktiv ist (ausschließlich).

Der angegebene Wert wird auf Minuten abgerundet.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
description string Beschreibung der Wartung.
maintenance_type integer Typ der Wartung.

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

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 „mit Datensammlung“ gesetzt ist. Es hat die folgenden Eigenschaften.

Eigenschaft Type Beschreibung
tag string Name des Problem-Tags.

Verhalten der Eigenschaft:
- erforderlich
operator integer Bedingungs-Operator.

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