Objeto de mantenimiento

Los siguientes objetos están directamente relacionados con la API 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.

Período de tiempo

El objeto de período de tiempo se utiliza para definir los períodos en los que debe entrar en vigor el mantenimiento. Tiene las siguientes propiedades.

Propiedad Tipo Descripción
period entero Duración del período de mantenimiento en segundos.

El valor dado se redondeará a la baja a minutos.

Valor predeterminado: 3600.
timeperiod_type entero Tipo de período de tiempo.

Valores posibles:
0 - (predeterminado) una sola vez;
2 - diario;
3 - semanal;
4 - mensual.
start_date timestamp Fecha en la que debe entrar en vigor el período de mantenimiento.
El valor dado se redondeará a minutos.

Valor predeterminado: fecha actual.

Comportamiento de la propiedad:
- compatible si timeperiod_type está configurado en "solo una vez"
start_time entero Hora del día en la que comienza el mantenimiento en segundos.
El valor dado se redondeará a minutos.

Valor predeterminado: 0.

Comportamiento de la propiedad:
- compatible si timeperiod_type está configurado en "diario", "semanal" o "mensual"
every entero Para los períodos diarios y semanales, every define los intervalos de día o semana en los que el mantenimiento debe entrar en vigencia.
Valor predeterminado si timeperiod_type está configurado en "daily" o "weekly": 1.

Para los períodos mensuales cuando se configura day, la propiedad every define el día del mes en el que el mantenimiento debe entrar en vigencia.
Valor predeterminado si timeperiod_type está configurado en "monthly" y day está configurado: 1.

Para los períodos mensuales cuando se configura dayofweek, la propiedad every define la semana del mes en la que el mantenimiento debe entrar en vigencia.
Valores posibles si timeperiod_type está configurado en "monthly" y dayofweek está configurado:
1 - (predeterminado) primera semana;
2 - segunda semana;
3 - tercera semana;
4 - cuarta semana;
5 - última semana.

Comportamiento de la propiedad:
- compatible si timeperiod_type está configurado como "diario", "semanal" o "mensual"
dayofweek entero Días de la semana en los que debe entrar en vigor el mantenimiento.

Posibles valores de mapa 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; Se acepta cualquier suma de valores de mapa de bits posibles (por ejemplo, 21 para lunes, miércoles y viernes).

Comportamiento de la propiedad:
- obligatorio si timeperiod_type está configurado en "semanal" o si timeperiod_type está configurado en "mensual" y day no está configurado
day entero Día del mes en el que debe entrar en vigencia el mantenimiento.

Comportamiento de la propiedad:
- obligatorio si timeperiod_type está configurado en "mensual" y dayofweek no está configurado
month entero Meses en los que debe entrar en vigor el mantenimiento.

Posibles valores de mapa 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 posibles valores de mapa de bits es aceptable (por ejemplo, 585 para enero, abril, julio y octubre).

Comportamiento de la propiedad:
- obligatorio 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:
- requerido
operator integer Operador de condición.

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