Objeto de mantenimiento

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

Mantenimiento

El objeto de mantenimiento tiene las siguientes propiedades.

Propiedad Tipo Descripción
maintenanceid ID ID del mantenimiento.

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

Comportamiento de la propiedad:
- 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:
- 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:
- 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 de etiquetas de problema.

Valores posibles:
0 - (por defecto) Y/O;
2 - O.

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 proporcionado se redondeará a la baja a minutos.

Por defecto: 3600.
timeperiod_type integer Tipo de periodo de tiempo.

Valores posibles:
0 - (por defecto) solo una vez;
2 - diario;
3 - semanal;
4 - mensual.
start_date timestamp Fecha en la que el periodo de mantenimiento debe entrar en vigor.
El valor proporcionado se redondeará a la baja a minutos.

Por defecto: fecha actual.

Comportamiento de la propiedad:
- soportado si timeperiod_type está establecido en "solo una vez"
start_time integer Hora del día en la que comienza el mantenimiento en segundos.
El valor proporcionado 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 de la máscara de bits 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 de la máscara de bits es aceptable (por ejemplo, 585 para Enero, Abril, Julio y Octubre).

Comportamiento de la propiedad:
- requerido si timeperiod_type está establecido en "mensual"

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 Maintenance está configurado como "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 condición.

Valores posibles:
0 - Igual;
2 - (por defecto) Contiene.
value string Valor de la etiqueta del problema.