[comment]: # aside: 1
[comment]: # translation:outdated
[comment]: # ({66e4c1be-c9539601})
# Oggetto manutenzione
I seguenti oggetti sono direttamente correlati all'API `maintenance`.
[comment]: # ({/66e4c1be-c9539601})
[comment]: # ({e31fd204-6c1a70bc})
### Manutenzione
L'oggetto manutenzione ha le seguenti proprietà.
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|maintenanceid|ID|ID della manutenzione.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *obbligatoria* per le operazioni di aggiornamento|
|name|string|Nome della manutenzione.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *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à](/manual/api/reference_commentary#property-behavior):
- *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à](/manual/api/reference_commentary#property-behavior):
- *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](/manual/maintenance#configuration) dei tag del problema.
Valori possibili:
0 - *(predefinito)* And/Or;
2 - Or.|
[comment]: # ({/e31fd204-6c1a70bc})
[comment]: # ({b0bb932e-506f52aa})
### 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](/manual/api/reference_commentary#data-types)|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à](/manual/api/reference_commentary#property-behavior):
- *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à](/manual/api/reference_commentary#property-behavior):
- *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à](/manual/api/reference_commentary#property-behavior):
- *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à](/manual/api/reference_commentary#property-behavior):
- *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à](/manual/api/reference_commentary#property-behavior):
- *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à](/manual/api/reference_commentary#property-behavior):
- *richiesta* se `timeperiod_type` è impostato su "mensile"|
[comment]: # ({/b0bb932e-506f52aa})
[comment]: # ({da08e754-2913a3ae})
### 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](#maintenance) è impostato su "with data collection".
Ha le seguenti proprietà.
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|tag|string|Nome del tag del problema.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
|operator|integer|[Operatore](/manual/maintenance#configuration) della condizione.
Valori possibili:
0 - Uguale;
2 - *(predefinito)* Contiene.|
|value|string|Valore del tag del problema.|
[comment]: # ({/da08e754-2913a3ae})