Objeto de serviço

Os seguintes objetos estão diretamente relacionados à API de service.

Serviço

O objeto serviço possui as seguintes propriedades.

Propriedade	Tipo	Descrição
serviceid	ID	ID do serviço. Comportamento da propriedade: - somente leitura - obrigatório para operações de atualização
algorithm	integer	Regra de cálculo de status. Aplicável apenas se existirem serviços filhos. Valores possíveis: 0 - definir status como OK; 1 - mais crítico se todos os filhos tiverem problemas; 2 - mais crítico dos serviços filhos. Comportamento da propriedade: - obrigatório para operações de criação
name	string	Nome do serviço. Comportamento da propriedade: - obrigatório para operações de criação
sortorder	integer	Posição do serviço usada para ordenação. Valores possíveis: 0-999. Comportamento da propriedade: - obrigatório para operações de criação
weight	integer	Peso do serviço. Valores possíveis: 0-1000000. Padrão: 0.
propagation_rule	integer	Regra de propagação de status. Valores possíveis: 0 - (padrão) propagar o status do serviço como está - sem alterações; 1 - aumentar o status propagado por um determinado `propagation_value` (de 1 a 5 severidades); 2 - diminuir o status propagado por um determinado `propagation_value` (de 1 a 5 severidades); 3 - ignorar este serviço - o status não é propagado para o serviço pai; 4 - definir status fixo do serviço usando um determinado `propagation_value`. Comportamento da propriedade: - obrigatório se `propagation_value` estiver definido
propagation_value	integer	Valor de propagação de status. Valores possíveis se `propagation_rule` for "0" ou "3": 0 - Não classificado. Valores possíveis se `propagation_rule` for "1" ou "2": 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. Valores possíveis se `propagation_rule` for "4": -1 - OK; 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. Comportamento da propriedade: - obrigatório se `propagation_rule` estiver definido
status	integer	Se o serviço está em estado OK ou de problema. Se o serviço estiver em estado de problema, `status` é igual a: - a severidade do problema mais crítico; - o status mais alto de um serviço filho em estado de problema. Se o serviço estiver em estado OK, `status` é igual a: -1. Comportamento da propriedade: - somente leitura
description	string	Descrição do serviço.
uuid	string	Identificador único universal, usado para vincular serviços importados aos já existentes. Gerado automaticamente, se não fornecido.
created_at	integer	Timestamp Unix quando o serviço foi criado.
readonly	boolean	Acesso ao serviço. Valores possíveis: 0 - Leitura e escrita; 1 - Somente leitura. Comportamento da propriedade: - somente leitura

Regra de status

O objeto de regra de status possui as seguintes propriedades.

Propriedade	Tipo	Descrição
type	integer	Condição para definir o status (Novo status). Valores possíveis: 0 - se pelo menos (N) serviços filhos tiverem status (Status) ou superior; 1 - se pelo menos (N%) dos serviços filhos tiverem status (Status) ou superior; 2 - se menos de (N) serviços filhos tiverem status (Status) ou inferior; 3 - se menos de (N%) dos serviços filhos tiverem status (Status) ou inferior; 4 - se o peso dos serviços filhos com status (Status) ou superior for pelo menos (W); 5 - se o peso dos serviços filhos com status (Status) ou superior for pelo menos (N%); 6 - se o peso dos serviços filhos com status (Status) ou inferior for menor que (W); 7 - se o peso dos serviços filhos com status (Status) ou inferior for menor que (N%). Onde: - N (W) é `limit_value`; - (Status) é `limit_status`; - (Novo status) é `new_status`. Comportamento da propriedade: - obrigatório
limit_value	integer	Valor limite. Valores possíveis: - para N e W: 1-100000; - para N%: 1-100. Comportamento da propriedade: - obrigatório
limit_status	integer	Status limite. Valores possíveis: -1 - OK; 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. Comportamento da propriedade: - obrigatório
new_status	integer	Novo valor de status. Valores possíveis: 0 - Não classificado; 1 - Informação; 2 - Aviso; 3 - Médio; 4 - Alto; 5 - Desastre. Comportamento da propriedade: - obrigatório

Tag de serviço

O objeto de tag de serviço possui as seguintes propriedades.

Propriedade	Tipo	Descrição
tag	string	Nome da tag de serviço. Comportamento da propriedade: - obrigatório
value	string	Valor da tag de serviço.

Alarme de serviço

Alarmes de serviço não podem ser criados, atualizados ou excluídos diretamente via API do Zabbix.

Os objetos de alarme de serviço representam uma mudança de estado do serviço. Eles possuem as seguintes propriedades.

Propriedade	Tipo	Descrição
clock	timestamp	Momento em que a mudança de estado do serviço ocorreu.
value	integer	Status do serviço. Consulte a propriedade `status` do serviço para uma lista de valores possíveis.

Tag de problema

As tags de problema permitem vincular serviços a eventos de problema. O objeto de tag de problema possui as seguintes propriedades.

Propriedade	Tipo	Descrição
tag	string	Nome da tag de problema. Comportamento da propriedade: - obrigatório
operator	integer	Operador da condição de mapeamento. Valores possíveis: 0 - (padrão) Igual; 2 - Contém.
value	string	Valor da tag de problema.

Documentation