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 | cadena | ID del mantenimiento. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualización |
| name | cadena | Nombre del mantenimiento. Comportamiento de la propiedad: - obligatorio para operaciones de creación |
| active_since | timestamp | Hora en que el mantenimiento se activa. El valor proporcionado se redondeará a minutos. Comportamiento de la propiedad: - obligatorio para operaciones de creación |
| active_till | timestamp | Hora en que el mantenimiento deja de estar activo. El valor dado se redondeará a minutos. Comportamiento de la propiedad: - obligatorio para operaciones de creación |
| description | cadena | 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 etiqueta de problema. Valores posibles: 0 - (predeterminado) Y/O; 2 - O. |
Periodo de tiempo
El objeto de período de tiempo se utiliza para definir períodos en los que el mantenimiento debe entrar en vigor. 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 minutos. Predeterminado: 3600. |
| timeperiod_type | entero | Tipo de período de tiempo. Valores posibles: 0 - (predeterminado) una sola vez; 2 - diario; 3 - semanal;< br>4 - mensual. |
| start_date | marca de tiempo | Fecha en la que el período de mantenimiento debe entrar en vigor. El valor proporcionado se redondeará a minutos. 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 que comienza el mantenimiento en segundos. El valor dado se redondeará a minutos. Predeterminado: 0. [Comportamiento de la propiedad] (/manual/api/reference_commentary#property-behavior): - compatible si timeperiod_type está configurado en "diario", "semanal" o "mensual" |
| every | entero | Para períodos diarios y semanales, cada define los intervalos de día o semana en los que el mantenimiento debe entrar en vigor.Valor predeterminado si timeperiod_type está configurado en "diario" o "semanal": 1. Para períodos mensuales en los que se establece día, la propiedad cada define el día del mes en el que el mantenimiento debe entrar en vigor.Valor predeterminado si timeperiod_type se establece en "mensual" y se establece día: 1.Para períodos mensuales en los que se establece día de la semana, la propiedad cada define la semana del mes en la que el mantenimiento debe entrar en vigor.Valores posibles si timeperiod_type está configurado en "mensual" y dayofweek está configurado:1 - (predeterminado) primera semana; 2 - segunda semana; 3 - tercera semana; 4 - cuarta semana; 5 - la semana pasada. Comportamiento de la propiedad: - compatible si timeperiod_type está configurado en "diario ", "semanal" o "mensual" |
| dayofweek | entero | Días de la semana en los que el mantenimiento debe entrar en vigor. Los días se almacenan en forma binaria y cada bit representa el día correspondiente. Por ejemplo, 4 equivale a 100 en binario y significa que el mantenimiento se habilitará el miércoles. Comportamiento de la propiedad: - obligatorio si timeperiod_type está configurado en "semanal", o si timeperiod_type está configurado en "mensual" y día no está configurado- compatible si timeperiod_type está configurado en "mensual" |
| day | entero | Día del mes en que el mantenimiento debe entrar en vigor. Comportamiento de la propiedad: - obligatorio si timeperiod_type está configurado en "mensual" y día de la semana no está configurado- compatible si timeperiod_type está configurado en "mensual" |
| month | entero | Meses en los que el mantenimiento debe entrar en vigor. Los meses se almacenan en forma binaria y cada bit representa el mes correspondiente. Por ejemplo, 5 equivale a 101 en binario y significa que el mantenimiento se habilitará en enero y marzo. Comportamiento de la propiedad: - obligatorio si timeperiod_type está configurado 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. |