Objeto de mantenimiento

Los siguientes objetos están directamente relacionados con la API de maintenance.

Mantenimiento

El objeto maintenance tiene las siguientes propiedades.

Property Type Description
maintenanceid ID ID del mantenimiento.

Comportamiento de la propiedad:
- solo lectura
- obligatorio para operaciones de actualización
name string Nombre del mantenimiento.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
active_since timestamp Hora en que el mantenimiento pasa a estar activo (inclusive).

El valor proporcionado se redondeará hacia abajo al minuto.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
active_till timestamp Hora en que el mantenimiento deja de estar activo (exclusiva).

El valor proporcionado se redondeará hacia abajo al minuto.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
description string Descripción del mantenimiento.
maintenance_type integer Tipo de mantenimiento.

Valores posibles:
0 - (predeterminado) con recopilación de datos;
1 - sin recopilación de datos.
tags_evaltype integer Método de evaluación de etiquetas de problema.

Valores posibles:
0 - (predeterminado) And/Or;
2 - Or.

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 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:
- 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:
- 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:
- 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:
- 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:
- 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:
- requerido si timeperiod_type está establecido en "mensual"

Nombre del evento

El objeto de nombre del evento se utiliza para definir qué problemas deben suprimirse cuando el mantenimiento entre en vigor.
Los nombres de eventos solo se pueden especificar si maintenance_type del objeto Maintenance está establecido en "with data collection".
Tiene las siguientes propiedades.

Property Type Description
operator integer Operador de la condición.

Valores posibles:
2 - (predeterminado) Contiene;
3 - No contiene.
value string Valor del nombre del evento.

Comportamiento de la propiedad:
- obligatorio

Etiqueta del problema

El objeto de etiqueta del problema se utiliza para definir qué problemas deben suprimirse cuando entre en vigor el mantenimiento. Las etiquetas solo se pueden especificar si maintenance_type del objeto de mantenimiento está establecido en "con recopilación de datos". Tiene las siguientes propiedades.

Propiedad Tipo Descripción
tag string Nombre de la etiqueta del problema.

Comportamiento de la propiedad:
- obligatorio
operator integer Operador de la condición.

Valores posibles:
0 - Igual a;
1 - No es igual a;
2 - (predeterminado) Contiene;
3 - No contiene.
value string Valor de la etiqueta del problema.