Oggetto manutenzione

I seguenti oggetti sono direttamente correlati all'API maintenance.

Maintenance

L'oggetto maintenance ha le seguenti proprietà.

Property Type Description
maintenanceid ID ID della maintenance.

Property behavior:
- read-only
- required for update operations
name string Nome della maintenance.

Property behavior:
- required for create operations
active_since timestamp Ora in cui la maintenance diventa attiva (inclusa).

Il valore fornito verrà arrotondato per difetto ai minuti.

Property behavior:
- required for create operations
active_till timestamp Ora in cui la maintenance smette di essere attiva (esclusa).

Il valore fornito verrà arrotondato per difetto ai minuti.

Property behavior:
- required for create operations
description string Descrizione della maintenance.
maintenance_type integer Tipo di maintenance.

Valori possibili:
0 - (default) con raccolta dati;
1 - senza raccolta dati.
tags_evaltype integer Metodo di valutazione dei tag del problema.

Valori possibili:
0 - (default) And/Or;
2 - Or.

Periodo di tempo

L'oggetto periodo di tempo viene utilizzato per definire i periodi in cui la manutenzione deve entrare in vigore. Ha le seguenti proprietà.

Proprietà Type Descrizione
period integer Durata del periodo di manutenzione in secondi.

Il valore specificato verrà arrotondato per difetto ai minuti.

Intervallo di valori possibili: 300 - 86399940.

Predefinito: 3600.
timeperiod_type integer Tipo di periodo di tempo.

Valori possibili:
0 - (predefinito) una sola volta;
2 - giornaliero;
3 - settimanale;
4 - mensile.
start_date timestamp Data in cui il periodo di manutenzione deve entrare in vigore.
Il valore specificato verrà arrotondato per difetto ai minuti.

Predefinito: data corrente.

Comportamento della proprietà:
- supportata se timeperiod_type è impostato su "una sola volta"
start_time integer Ora del giorno in cui la manutenzione inizia, in secondi.
Il valore specificato verrà arrotondato per difetto ai minuti.

Predefinito: 0.

Comportamento della proprietà:
- supportata se timeperiod_type è impostato su "giornaliero", "settimanale" o "mensile"
every integer Per i periodi giornalieri e settimanali, every definisce gli intervalli di giorni o settimane ai quali la manutenzione deve entrare in vigore.
Valore predefinito se timeperiod_type è impostato su "giornaliero" o "settimanale": 1.

Per i periodi mensili, quando day è impostato, la proprietà every definisce il giorno del mese in cui la manutenzione deve entrare in vigore.
Valore predefinito se timeperiod_type è impostato su "mensile" e day è impostato: 1.

Per i periodi mensili, quando dayofweek è impostato, la proprietà every definisce la settimana del mese in cui la manutenzione deve entrare in vigore.
Valori possibili se timeperiod_type è impostato su "mensile" e dayofweek è impostato:
1 - (predefinito) prima settimana;
2 - seconda settimana;
3 - terza settimana;
4 - quarta settimana;
5 - ultima settimana.

Comportamento della proprietà:
- supportata se timeperiod_type è impostato su "giornaliero", "settimanale" o "mensile"
dayofweek integer Giorni della settimana in cui la manutenzione deve entrare in vigore.

Valori bitmap possibili:
1 - lunedì;
2 - martedì;
4 - mercoledì;
8 - giovedì;
16 - venerdì;
32 - sabato;
64 - domenica.

Questo è un campo bitmask; è accettata qualsiasi somma dei valori bitmap possibili (ad esempio, 21 per lunedì, mercoledì e venerdì).

Comportamento della proprietà:
- richiesta se timeperiod_type è impostato su "settimanale" oppure se timeperiod_type è impostato su "mensile" e day non è impostato
day integer Giorno del mese in cui la manutenzione deve entrare in vigore.

Comportamento della proprietà:
- richiesta se timeperiod_type è impostato su "mensile" e dayofweek non è impostato
month integer Mesi in cui la manutenzione deve entrare in vigore.

Valori bitmap possibili:
1 - gennaio;
2 - febbraio;
4 - marzo;
8 - aprile;
16 - maggio;
32 - giugno;
64 - luglio;
128 - agosto;
256 - settembre;
512 - ottobre;
1024 - novembre;
2048 - dicembre.

Questo è un campo bitmask; è accettata qualsiasi somma dei valori bitmap possibili (ad esempio, 585 per gennaio, aprile, luglio e ottobre).

Comportamento della proprietà:
- richiesta se timeperiod_type è impostato su "mensile"

Tag del problema

L'oggetto tag del problema viene utilizzato per definire quali problemi devono essere soppressi quando la manutenzione entra in vigore. I tag possono essere specificati solo se maintenance_type dell'oggetto Maintenance è impostato su "with data collection". Ha le seguenti proprietà.

Property Type Description
tag string Nome del tag del problema.

Comportamento della proprietà:
- required
operator integer Operatore della condizione.

Valori possibili:
0 - Uguale;
2 - (default) Contiene.
value string Valore del tag del problema.