[comment]: # aside: 1

[comment]: # ({3ba1b4af-4e570b8c})
# Objeto SLA

Os seguintes objetos estão diretamente relacionados à API `sla` (Acordo de Nível de Serviço).

[comment]: # ({/3ba1b4af-4e570b8c})

[comment]: # ({f86724cb-8451803c})
### SLA

O objeto SLA possui as seguintes propriedades.

|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|slaid|ID|ID do SLA.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *somente leitura*<br>- *obrigatório* para operações de atualização|
|name|string|Nome do SLA.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|period|integer|Período de relatório do SLA.<br><br>Valores possíveis:<br>0 - diário;<br>1 - semanal;<br>2 - mensal;<br>3 - trimestral;<br>4 - anual.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|slo|float|Objetivo de Nível de Serviço mínimo aceitável expresso em percentual. Se o Indicador de Nível de Serviço (SLI) cair abaixo, o SLA é considerado em estado de problema/não cumprido.<br><br>Valores possíveis: 0-100 (até 4 casas decimais).<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|effective_date|integer|Data de início de vigência do SLA.<br><br>Valores possíveis: timestamp da data em UTC.|
|timezone|string|Fuso horário do relatório, por exemplo: `Europe/London`, `UTC`.<br><br>Para a lista completa de fusos horários suportados, consulte a [documentação do PHP](https://www.php.net/manual/en/timezones.php).<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório* para operações de criação|
|status|integer|Status do SLA.<br><br>Valores possíveis:<br>0 - *(padrão)* SLA desabilitado;<br>1 - SLA habilitado.|
|description|string|Descrição do SLA.|

[comment]: # ({/f86724cb-8451803c})

[comment]: # ({a1388fd1-632f7fa7})
### Agenda de SLA

O objeto de agenda de SLA define períodos em que o(s) serviço(s) conectado(s) estão programados para estar em funcionamento.
Ele possui as seguintes propriedades.

[comment]: # ({/a1388fd1-632f7fa7})

[comment]: # ({4e05dd64-db954c0c})
|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|period\_from|integer|Hora de início do período semanal recorrente (inclusive).<br><br>Valores possíveis: número de segundos (contando a partir de domingo).<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|period\_to|integer|Hora de término do período semanal recorrente (exclusivo).<br><br>Valores possíveis: número de segundos (contando a partir de domingo).<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|

[comment]: # ({/4e05dd64-db954c0c})

[comment]: # ({79292401-5bbe7eb6})
### SLA - tempo de inatividade excluído

O objeto de tempo de inatividade excluído define períodos em que o(s) serviço(s) conectado(s) estão programados para ficar fora de operação,
sem afetar o SLI, por exemplo, durante uma manutenção planejada.
Ele possui as seguintes propriedades.

[comment]: # ({/79292401-5bbe7eb6})

[comment]: # ({1545530a-fa71231c})
|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|name|string|Nome do tempo de inatividade excluído.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|period\_from|integer|Hora de início do tempo de inatividade excluído (inclusivo).<br><br>Valores possíveis: timestamp.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|period\_to|integer|Hora de término do tempo de inatividade excluído (exclusivo).<br><br>Valores possíveis: timestamp.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|

[comment]: # ({/1545530a-fa71231c})

[comment]: # ({23d825be-9f9ccbfd})
### Tag de serviço de SLA

O objeto de tag de serviço de SLA vincula os serviços a serem incluídos nos cálculos do SLA. Ele possui as seguintes propriedades.

[comment]: # ({/23d825be-9f9ccbfd})

[comment]: # ({77e50fa6-e4881380})
|Propriedade|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|tag|string|Nome da tag do serviço SLA.<br><br>[Comportamento da propriedade](/manual/api/reference_commentary#property-behavior):<br>- *obrigatório*|
|operator|integer|[Operador](/manual/it_services/sla#configuration) da tag do serviço SLA.<br><br>Valores possíveis:<br>0 - *(padrão)* Igual;<br>2 - Contém.|
|value|string|Valor da tag do serviço SLA.|

[comment]: # ({/77e50fa6-e4881380})