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 | (lecturaobligatoria) ID del mantenimiento. |
| name (obligatorio) |
cadena | Nombre del mantenimiento. |
| active_since (obligatorio) |
marca de tiempo | Hora en que el mantenimiento se activa. El valor proporcionado se redondeará a minutos. |
| active_till (obligatorio) |
marca de tiempo | Hora en que el mantenimiento deja de estar activo. El valor proporcionado se redondeará a minutos. |
| description | cadena | Descripción del mantenimiento. |
| maintenance_type | número entero | Tipo de mantenimiento. Valores posibles: 0 - (predeterminado) con recopilación de datos; 1 - sin recopilación de datos. |
| tags_evaltype | número entero | Método de evaluación de etiqueta de problema. Valores posibles: 0 - (predeterminado) Y/O; 2 - O. |
Tenga en cuenta que para algunos métodos (actualizar, eliminar) la combinación de parámetros requeridos/opcionales es diferente.
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 | número entero | Duración del período de mantenimiento en segundos. El valor dado se redondeará a minutos. Predeterminado: 3600. |
| timeperiod_type | número 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. Se utiliza solo durante un período de tiempo. El valor proporcionado se redondeará a minutos. < br>Predeterminado: fecha actual. |
| start_time | número entero | Hora del día en que comienza el mantenimiento en segundos. Se utiliza para períodos diarios, semanales y mensuales. El valor dado se redondeará a minutos.<br > Predeterminado: 0. |
| every | entero | Se utiliza para períodos diarios, semanales y mensuales. Para períodos diarios y semanales, every define intervalos de días o semanas en los que el mantenimiento debe entrar en vigor.Valor predeterminado: 1. Para períodos mensuales, si la propiedad dayofweek contiene al menos un día de la semana seleccionado, la propiedad every define la semana del mes en la que el mantenimiento debe entrar en vigor.<br >Valores posibles: 1 - (predeterminado) primera semana; 2 - segunda semana; 3 - tercera semana; 4 - cuarta semana; 5 - última semana. |
| dayofweek | número 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. Se utiliza para períodos de tiempo semanales y mensuales. Requerido solo para períodos de tiempo semanales. Se debe especificar al menos un dayofweek o day para períodos de tiempo mensuales. |
| day | número entero | Día del mes en el que el mantenimiento debe entrar en vigor. Se usa solo para períodos de tiempo mensuales. Se debe especificar al menos un día de la semana o día para periodos de tiempo mensuales. |
| month | número 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. Requerido solo durante períodos de tiempo mensuales. |
Etiqueta de problema
El objeto de etiqueta de problema se utiliza para definir qué problemas deben suprimirse cuando el mantenimiento entre en vigor. Tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| etiqueta (obligatorio) |
cadena | Nombre de etiqueta del problema. |
| operator | número entero | Operador de condición. Valores posibles: 0 - Igual; 2 - (predeterminado) Contiene. |
| value | cadena | Valor de etiqueta de problema. |
Las etiquetas solo se pueden especificar para períodos de mantenimiento con recopilación de datos ("maintenance_type":0`).