[comment]: # translation:outdated

[comment]: # ({c9539601-c9539601})
# > Objeto de manutenção

Os objetos a seguir estão diretamente relacionados à API `maintenance`.

[comment]: # ({/c9539601-c9539601})

[comment]: # ({018c9a37-6c1a70bc})
### Manutenção

O objeto de manutenção tem as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|--|--|------|
|maintenanceid|string|*(somente leitura)* ID da manutenção.|
|**name**<br>(required)|string|Nome da manutenção.|
|**active\_since**<br>(requerido)|timestamp|Hora em que a manutenção se torna ativa.<br><br>O valor fornecido será arredondado para minutos.|
|**active\_till**<br>(requerido)|timestamp|Hora em que a manutenção deixa de estar ativa.<br><br>O valor fornecido será arredondado para minutos.|
|description|string|Descrição da manutenção.|
|maintenance\_type|integer|Tipo de manutenção.<br><br>Valores possíveis:<br>0 - *(padrão)* com coleta de dados;<br>1 - sem coleta de dados.|
|tags\_evaltype|integer|Método de avaliação da tag do problema.<br><br>Valores possíveis:<br>0 - *(padrão)* And/Or;<br>2 - Or.|

[comment]: # ({/018c9a37-6c1a70bc})

[comment]: # ({51d5f555-506f52aa})
### 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](/manual/api/reference_commentary#data_types)|Descrição|
|--|--|------|
|period|integer|Duração do período de manutenção em segundos.<br><br>O valor fornecido será arredondado para minutos.<br><br>Padrão: 3600.|
|timeperiod\_type|integer|Tipo de período de tempo.<br><br>Valores possíveis:<br>0 - *(padrão)* apenas uma vez;<br>2 - diariamente;<br>3 - semanalmente;<br>4 - mensalmente.|
|start\_date|timestamp|Data em que o período de manutenção deve entrar em vigor.<br><br>Usado apenas para períodos de tempo.<br><br>O valor fornecido será arredondado para minutos.<br><br>Padrão: data atual.|
|start\_time|integer|Hora do dia em que a manutenção começa em segundos.<br><br>Usado para períodos diários, semanais e mensais.<br><br>O valor fornecido será arredondado para minutos.<br><br>Padrão: 0.|
|every|integer|Usado para períodos diários, semanais e mensais.<br><br>Para períodos diários e semanais, `every` define intervalos de dias ou semanas em que a manutenção deve entrar em vigor.<br><br>Padrão: 1.<br><br>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.<br><br>Valores possíveis:<br>1 - *(padrão)* primeira semana;<br>2 - segunda semana;<br>3 - terceira semana;<br>4 - quarta semana;<br>5 - última semana.|
|dayofweek|integer|Dias da semana em que a manutenção deve entrar em vigor.<br><br>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.<br><br>Usado para períodos semanais e mensais. Necessário apenas para períodos semanais.<br><br>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.<br><br>Usado apenas para períodos mensais.<br><br>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.<br><br>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.<br><br>Necessário apenas para períodos mensais.|

[comment]: # ({/51d5f555-506f52aa})

[comment]: # ({9b9022ef-2913a3ae})
### 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](/manual/api/reference_commentary#data_types)|Descrição|
|--|--|------|
|**tag**<br>(required)|string|Nome da tag do problema.|
|operator|integer|Operador de condição.<br><br>Valores possíveis:<br>0 - Igual a;<br>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`).

[comment]: # ({/9b9022ef-2913a3ae})
