Documentation
Table of Contents
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 que el mantenimiento se activa (inclusive). El valor dado se redondeará hacia abajo a minutos. Comportamiento de la propiedad: - requerido para operaciones de creación |
| active_till | timestamp | Hora en que el mantenimiento deja de estar activo (exclusivo). El valor dado se redondeará hacia abajo 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 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 - (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 entre en vigor. Las etiquetas solo se pueden especificar si maintenance_type de objeto de mantenimiento está configurado en "con recopilación de datos". Tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | cadena | Nombre de etiqueta del problema. Comportamiento de la propiedad: - obligatorio |
| operator | entero | Operador de condición. Valores posibles: 0 - Igual; 2 - (predeterminado) Contiene. |
| value | cadena | Valor de etiqueta de problema. |