Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

> 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).