Table of Contents
> Objeto de serviço
Os objetos a seguir estão diretamente relacionados à API service.
Serviço
O objeto de serviço tem as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| serviceid | string | (somente leitura) ID do serviço. |
| algorithm (requerido) |
integer | Regra de cálculo de status. Aplicável apenas se existirem serviços filhos. Valores possíveis: 0 - definir o status como OK; 1 - mais crítico se todos os serviços filhos tiverem problemas; 2 - mais crítico dos serviços filho. |
| name (requerido) |
string | Nome do serviço. |
| sortorder (requerido) |
integer | Posição do serviço usado para classificação. Valores possíveis: 0-999. |
| weight | integer | Peso do serviço. Valores possíveis: 0-1000000. Padrão: 0. |
| propagation_rule | integer | Regra de propagação de status. Deve ser definido junto com propagation_value.Valores possíveis: 0 - (padrão) propagar o status do serviço como está - sem alterações; 1 - aumentar o status propagado em um determinado propagation_value (por 1 a 5 gravidades);2 - diminuir o status propagado por um determinado propagation_value (por 1 a 5 gravidades);3 - ignorar este serviço - o status não é propagado para o serviço pai; 4 - defina o status do serviço fixo usando um determinado propagation_value. |
| propagation_value | integer | Valor de propagação de status. Deve ser definido junto com propagation_rule.Valores possíveis para propagation_rule com valores 0 e 3: 0.Valores possíveis para propagation_rule com valores 1 e 2: 1-5.Possíveis valores para propagation_rule com valor 4:-1 - OK; 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. |
| status | integer | (somente leitura) Se o serviço está OK ou com problema. Se o serviço estiver com problema, status é igual a:- a gravidade do problema mais crítico;<br >- o status mais alto de um serviço filho em estado de problema. Se o serviço estiver em estado OK, status será igual a -1. |
| description | string | Descrição do serviço. |
| uuid | string | Identificador único universal. Para operações de atualização, este campo é somente leitura. |
| created_at | integer | Timestamp Unix quando o serviço foi criado. |
| readonly | boolean | (readonly) Acesso ao serviço. Valores possíveis: 0 - leitura-gravação; 1 - somente leitura. |
Regra de status
O objeto de regra de status tem as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| type (requerido) |
integer | Condição para definir o status (status Novo). Valores possíveis: 0 - se pelo menos (N) serviços filho tiverem status (Status) ou superior; 1 - se pelo menos (N%) dos serviços de apoio à criança têm estatuto (Status) ou superior; 2 - se menos de (N) serviços infantis tiverem status (Status) ou inferior; 3 - se menos de (N%) dos serviços à criança tiverem status (Status) ou inferior; 4 - se o peso dos serviços infantis com status (Status) ou superior for no mínimo (W); 5 - se o peso dos serviços infantis com status (Status) ou superior for pelo menos (N%); 6 - se o peso dos serviços infantis com status (Status) ou inferior for menor que (W); 7 - se o peso dos serviços filho com status (Status) ou abaixo for menor que (N%). Onde: - N (W) é limit_value;- (Status) é limit_status;- (status Novo) é new_status. |
| limit_value (requerido) |
integer | Valor limite. Valores possíveis: - para N e W: 1-100000; - para N%: 1-100. |
| limit_status (requerido) |
integer | Status do limite. Valores possíveis: -1 - OK; 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Média; 4 - Alta; 5 - Desastre. |
| new_status (requerido) |
integer | Novo valor de status. Valores possíveis: 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. |
Etiqueta de serviço
O objeto de etiqueta de serviço tem as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| tag (required) |
string | Nome da etiqueta de serviço. |
| value | string | Valor da etiqueta de serviço. |
Alarme de serviço
Os alarmes de serviço não podem ser criados, atualizados ou excluídos diretamente pela API do Zabbix.
Os objetos de alarme de serviço representam a mudança de estado de um serviço. Tem as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| clock | timestamp | Hora em que a mudança de estado do serviço aconteceu. |
| value | integer | Status do serviço. Consulte a propriedade do status do serviço para obter uma lista de valores possíveis. |
Etiqueta do problema
As etiquetas de problema permitem vincular serviços a eventos de problema. O objeto de etiquetas de problema tem as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| tag (requerido) |
string | Nome da etiqueta do problema. |
| operator | integer | Operador de condição de mapeamento. Valores possíveis: 0 - (padrão) é igual; 2 - igual. |
| value | string | Valor da etiqueta do problema. |