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"

Znacznik problemu

Obiekt znacznika problemu służy do określenia, które problemy muszą zostać wyciszone, gdy konserwacja zacznie obowiązywać. Tagi można określić tylko wtedy, gdy maintenance_type obiektu Maintenance jest ustawiony na "with data collection". Ma on następujące właściwości.

Property Type Description
tag string Nazwa znacznika problemu.

Property behavior:
- required
operator integer Operator warunku.

Możliwe wartości:
0 - Równe;
2 - (domyślnie) Zawiera.
value string Wartość znacznika problemu.