Table of Contents
> Objeto de manutenção
Os objetos a seguir estão diretamente relacionados à API maintenance.
Manutenção
O objeto de manutenção tem as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| maintenanceid | string | (somente leitura) ID da manutenção. |
| name (required) |
string | Nome da manutenção. |
| active_since (requerido) |
timestamp | Hora em que a manutenção se torna ativa. O valor fornecido será arredondado para minutos. |
| active_till (requerido) |
timestamp | Hora em que a manutenção deixa de estar ativa. O valor fornecido será arredondado para minutos. |
| description | string | Descrição da manutenção. |
| maintenance_type | integer | Tipo de manutenção. Valores possíveis: 0 - (padrão) com coleta de dados; 1 - sem coleta de dados. |
| tags_evaltype | integer | Método de avaliação da tag do problema. Valores possíveis: 0 - (padrão) And/Or; 2 - Or. |
Período de tempo
O objeto período de tempo é utilizado para definir os períodos em que a manutenção deve entrar em vigor. Tem as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| period | integer | Duração do período de manutenção em segundos. O valor fornecido será arredondado para minutos. Padrão: 3600. |
| timeperiod_type | integer | Tipo de período de tempo. Valores possíveis: 0 - (padrão) apenas uma vez; 2 - diariamente; 3 - semanalmente; 4 - mensalmente. |
| start_date | timestamp | Data em que o período de manutenção deve entrar em vigor. Usado apenas para períodos de tempo. O valor fornecido será arredondado para minutos. Padrão: data atual. |
| start_time | integer | Hora do dia em que a manutenção começa em segundos. Usado para períodos diários, semanais e mensais. O valor fornecido será arredondado para minutos. Padrão: 0. |
| every | integer | Usado para períodos diários, semanais e mensais. Para períodos diários e semanais, every define intervalos de dias ou semanas em que a manutenção deve entrar em vigor.Padrão: 1. Para períodos mensais, se a propriedade dayofweek contiver pelo menos um dia da semana selecionado, a propriedade every definirá a semana do mês em que a manutenção deve entrar em vigor.Valores possíveis: 1 - (padrão) primeira semana; 2 - segunda semana; 3 - terceira semana; 4 - quarta semana; 5 - última semana. |
| dayofweek | integer | Dias da semana em que a manutenção deve entrar em vigor. Os dias são armazenados em formato binário com cada bit representando o dia correspondente. Por exemplo, 4 é igual a 100 em binário e significa que a manutenção será habilitada na quarta-feira. Usado para períodos semanais e mensais. Necessário apenas para períodos semanais. Pelo menos um dayofweek ou day deve ser especificado para períodos mensais. |
| day | integer | Dia do mês em que a manutenção deve entrar em vigor. Usado apenas para períodos mensais. Pelo menos um dayofweek ou day deve ser especificado para períodos mensais. |
| month | integer | Meses em que a manutenção deve entrar em vigor. Os meses são armazenados em formato binário com cada bit representando o mês correspondente. Por exemplo, 5 é igual a 101 em binário e significa que a manutenção será ativada em janeiro e março. Necessário apenas para períodos mensais. |
Tag do problema
O objeto tag de problema é utilizado para definir quais problemas devem ser suprimidos quando a manutenção entrar em vigor. Ele tem as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| tag (required) |
string | Nome da tag do problema. |
| operator | integer | Operador de condição. Valores possíveis: 0 - Igual a; 2 - (padrão) Contém. |
| value | string | Valor da tag do problema. |
Tags só podem ser especificadas para períodos de manutenção com coleta de dados ("maintenance_type":0).