[comment]: # aside: 1
[comment]: # ({66e4c1be-c9539601})
# Objeto de mantenimiento
Los siguientes objetos están directamente relacionados con la API de `maintenance`.
[comment]: # ({/66e4c1be-c9539601})
[comment]: # ({e31fd204-6c1a70bc})
### Mantenimiento
El objeto de mantenimiento tiene las siguientes propiedades.
|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|maintenanceid|ID|ID del mantenimiento.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *solo lectura*
- *requerido* para operaciones de actualización|
|name|string|Nombre del mantenimiento.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido* para operaciones de creación|
|active\_since|timestamp|Hora en la que el mantenimiento se activa (inclusive).
El valor dado se redondeará a minutos.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido* para operaciones de creación|
|active\_till|timestamp|Hora en la que el mantenimiento deja de estar activo (exclusivo).
El valor dado se redondeará a minutos.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido* para operaciones de creación|
|description|string|Descripción del mantenimiento.|
|maintenance\_type|integer|Tipo de mantenimiento.
Valores posibles:
0 - *(por defecto)* con recolección de datos;
1 - sin recolección de datos.|
|tags\_evaltype|integer|[Método de evaluación](/manual/maintenance#configuration) de etiquetas de problema.
Valores posibles:
0 - *(por defecto)* And/Or;
2 - Or.|
[comment]: # ({/e31fd204-6c1a70bc})
[comment]: # ({b0bb932e-506f52aa})
### Periodo de tiempo
El objeto periodo de tiempo se utiliza para definir los periodos en los que el mantenimiento debe entrar en vigor.
Tiene las siguientes propiedades.
|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|period|integer|Duración del periodo de mantenimiento en segundos.
El valor dado se redondeará a la baja a minutos.
Valores posibles: 300 - 86399940.
Por defecto: 3600.|
|timeperiod\_type|integer|Tipo de periodo de tiempo.
Valores posibles:
0 - *(por defecto)* una sola vez;
2 - diario;
3 - semanal;
4 - mensual.|
|start\_date|timestamp|Fecha en la que el periodo de mantenimiento debe entrar en vigor.
El valor dado se redondeará a la baja a minutos.
Por defecto: fecha actual.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *soportado* si `timeperiod_type` está establecido en "una sola vez"|
|start\_time|integer|Hora del día en la que comienza el mantenimiento en segundos.
El valor dado se redondeará a la baja a minutos.
Por defecto: 0.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *soportado* si `timeperiod_type` está establecido en "diario", "semanal" o "mensual"|
|every|integer|Para periodos diarios y semanales, `every` define los intervalos de días o semanas en los que el mantenimiento debe entrar en vigor.
Valor por defecto si `timeperiod_type` está establecido en "diario" o "semanal": 1.
Para periodos mensuales cuando se establece `day`, la propiedad `every` define el día del mes en el que el mantenimiento debe entrar en vigor.
Valor por defecto si `timeperiod_type` está establecido en "mensual" y se establece `day`: 1.
Para periodos mensuales cuando se establece `dayofweek`, la propiedad `every` define la semana del mes en la que el mantenimiento debe entrar en vigor.
Valores posibles si `timeperiod_type` está establecido en "mensual" y se establece `dayofweek`:
1 - *(por defecto)* primera semana;
2 - segunda semana;
3 - tercera semana;
4 - cuarta semana;
5 - última semana.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *soportado* si `timeperiod_type` está establecido en "diario", "semanal" o "mensual"|
|dayofweek|integer|Días de la semana en los que el mantenimiento debe entrar en vigor.
Valores posibles de la máscara de bits:
1 - Lunes;
2 - Martes;
4 - Miércoles;
8 - Jueves;
16 - Viernes;
32 - Sábado;
64 - Domingo.
Este es un campo de máscara de bits; cualquier suma de los valores posibles es aceptable (por ejemplo, 21 para lunes, miércoles y viernes).
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido* si `timeperiod_type` está establecido en "semanal" o si `timeperiod_type` está establecido en "mensual" y `day` no está establecido|
|day|integer|Día del mes en el que el mantenimiento debe entrar en vigor.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido* si `timeperiod_type` está establecido en "mensual" y `dayofweek` no está establecido|
|month|integer|Meses en los que el mantenimiento debe entrar en vigor.
Valores posibles de la máscara de bits:
1 - Enero;
2 - Febrero;
4 - Marzo;
8 - Abril;
16 - Mayo;
32 - Junio;
64 - Julio;
128 - Agosto;
256 - Septiembre;
512 - Octubre;
1024 - Noviembre;
2048 - Diciembre.
Este es un campo de máscara de bits; cualquier suma de los valores posibles es aceptable (por ejemplo, 585 para enero, abril, julio y octubre).
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido* si `timeperiod_type` está establecido en "mensual"|
[comment]: # ({/b0bb932e-506f52aa})
[comment]: # ({da08e754-2913a3ae})
### Etiqueta de problema
El objeto de etiqueta de problema se utiliza para definir qué problemas deben suprimirse cuando el mantenimiento entra en vigor.
Las etiquetas solo se pueden especificar si `maintenance_type` del [objeto de mantenimiento](#maintenance) está configurado como "con recopilación de datos".
Tiene las siguientes propiedades.
|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|tag|string|Nombre de la etiqueta del problema.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio*|
|operator|integer|[Operador](/manual/maintenance#configuration) de condición.
Valores posibles:
0 - Igual;
2 - *(por defecto)* Contiene.|
|value|string|Valor de la etiqueta del problema.|
[comment]: # ({/da08e754-2913a3ae})