Obiekt konserwacji

Następujące obiekty są bezpośrednio powiązane z API maintenance.

Konserwacja

Obiekt konserwacji ma następujące właściwości.

Property Type Description
maintenanceid ID ID konserwacji.

Zachowanie właściwości:
- tylko do odczytu
- wymagane dla operacji aktualizacji
name string Nazwa konserwacji.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
active_since timestamp Czas, od którego konserwacja staje się aktywna (włącznie).

Podana wartość zostanie zaokrąglona w dół do minut.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
active_till timestamp Czas, do którego konserwacja pozostaje aktywna (wyłącznie).

Podana wartość zostanie zaokrąglona w dół do minut.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
description string Opis konserwacji.
maintenance_type integer Typ konserwacji.

Możliwe wartości:
0 - (domyślnie) z pobieraniem danych;
1 - bez pobierania danych.
tags_evaltype integer Metoda oceny tagów problemu.

Możliwe wartości:
0 - (domyślnie) And/Or;
2 - Or.

Okres czasu

Obiekt okresu czasu służy do definiowania okresów, w których konserwacja ma wejść w życie. Ma następujące właściwości.

Property Type Description
period integer Czas trwania okresu konserwacji w sekundach.

Podana wartość zostanie zaokrąglona w dół do pełnych minut.

Możliwy zakres wartości: 300 - 86399940.

Domyślnie: 3600.
timeperiod_type integer Typ okresu czasu.

Możliwe wartości:
0 - (domyślnie) tylko jeden raz;
2 - codziennie;
3 - co tydzień;
4 - co miesiąc.
start_date timestamp Data, kiedy okres konserwacji ma wejść w życie.
Podana wartość zostanie zaokrąglona w dół do pełnych minut.

Domyślnie: bieżąca data.

Zachowanie właściwości:
- obsługiwane, jeśli timeperiod_type jest ustawione na "one time only"
start_time integer Pora dnia, o której konserwacja rozpoczyna się, wyrażona w sekundach.
Podana wartość zostanie zaokrąglona w dół do pełnych minut.

Domyślnie: 0.

Zachowanie właściwości:
- obsługiwane, jeśli timeperiod_type jest ustawione na "daily", "weekly" lub "monthly"
every integer Dla okresów dziennych i tygodniowych every określa interwały dni lub tygodni, z jakimi konserwacja ma wejść w życie.
Wartość domyślna, jeśli timeperiod_type jest ustawione na "daily" lub "weekly": 1.

Dla okresów miesięcznych, gdy ustawiono day, właściwość every określa dzień miesiąca, w którym konserwacja ma wejść w życie.
Wartość domyślna, jeśli timeperiod_type jest ustawione na "monthly" i ustawiono day: 1.

Dla okresów miesięcznych, gdy ustawiono dayofweek, właściwość every określa tydzień miesiąca, w którym konserwacja ma wejść w życie.
Możliwe wartości, jeśli timeperiod_type jest ustawione na "monthly" i ustawiono dayofweek:
1 - (domyślnie) pierwszy tydzień;
2 - drugi tydzień;
3 - trzeci tydzień;
4 - czwarty tydzień;
5 - ostatni tydzień.

Zachowanie właściwości:
- obsługiwane, jeśli timeperiod_type jest ustawione na "daily", "weekly" lub "monthly"
dayofweek integer Dni tygodnia, w których konserwacja ma wejść w życie.

Możliwe wartości bitmapy:
1 - poniedziałek;
2 - wtorek;
4 - środa;
8 - czwartek;
16 - piątek;
32 - sobota;
64 - niedziela.

To pole jest maską bitową; akceptowalna jest dowolna suma możliwych wartości bitmapy (na przykład 21 dla poniedziałku, środy i piątku).

Zachowanie właściwości:
- wymagane, jeśli timeperiod_type jest ustawione na "weekly" lub jeśli timeperiod_type jest ustawione na "monthly" i day nie jest ustawione
day integer Dzień miesiąca, w którym konserwacja ma wejść w życie.

Zachowanie właściwości:
- wymagane, jeśli timeperiod_type jest ustawione na "monthly" i dayofweek nie jest ustawione
month integer Miesiące, w których konserwacja ma wejść w życie.

Możliwe wartości bitmapy:
1 - styczeń;
2 - luty;
4 - marzec;
8 - kwiecień;
16 - maj;
32 - czerwiec;
64 - lipiec;
128 - sierpień;
256 - wrzesień;
512 - październik;
1024 - listopad;
2048 - grudzień.

To pole jest maską bitową; akceptowalna jest dowolna suma możliwych wartości bitmapy (na przykład 585 dla stycznia, kwietnia, lipca i października).

Zachowanie właściwości:
- wymagane, jeśli timeperiod_type jest ustawione na "monthly"

Nazwa zdarzenia

Obiekt nazwy zdarzenia służy do określania, które problemy muszą zostać wyciszone po rozpoczęciu okresu utrzymania. Nazwy zdarzeń można określić tylko wtedy, gdy parametr maintenance_type obiektu Maintenance jest ustawiony na „with data collection”. Obiekt ma następujące właściwości.

Property Type Description
operator integer Operator warunku.

Możliwe wartości:
2 - (domyślnie) Zawiera;
3 - Nie zawiera.
value string Wartość nazwy zdarzenia.

Zachowanie właściwości:
- wymagane

Tag problemu

Obiekt tagu problemu służy do określania, które problemy muszą zostać wyciszone po rozpoczęciu okresu utrzymania. Tagi można określać tylko wtedy, gdy parametr maintenance_type obiektu Maintenance jest ustawiony na „with data collection”. Obiekt ma następujące właściwości.

Property Type Description
tag string Nazwa tagu problemu.

Zachowanie właściwości:
- required
operator integer Warunek operatora.

Możliwe wartości:
0 - Równa się;
1 - Nie równa się;
2 - (default) Zawiera;
3 - Nie zawiera.
value string Wartość tagu problemu.