Table of Contents
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. El valor proporcionado se redondeará hacia abajo 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. El valor proporcionado 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 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 de Mantenimiento está configurado como "con recopilación de datos". Tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | string | Nombre de la etiqueta de 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 de problema. |