Oggetto manutenzione

I seguenti oggetti sono direttamente correlati all'API maintenance.

Manutenzione

L'oggetto manutenzione ha le seguenti proprietà.

Proprietà Type Descrizione
maintenanceid ID ID della manutenzione.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
name string Nome della manutenzione.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
active_since timestamp Ora in cui la manutenzione diventa attiva (inclusa).

Il valore specificato verrà arrotondato per difetto ai minuti.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
active_till timestamp Ora in cui la manutenzione cessa di essere attiva (esclusa).

Il valore specificato verrà arrotondato per difetto ai minuti.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
description string Descrizione della manutenzione.
maintenance_type integer Tipo di manutenzione.

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

Valori possibili:
0 - (predefinito) 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à.

Proprietà Tipo Descrizione
tag string Nome del tag del problema.

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

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