Objeto media type

Os seguintes objetos estão diretamente relacionados à API mediatype.

Tipo de mídia

O objeto de tipo de mídia tem as seguintes propriedades.

Propriedade Tipo Descrição
mediatypeid ID ID do tipo de mídia.

Comportamento da propriedade:
- somente leitura
- obrigatório para operações de atualização
name string Nome do tipo de mídia.

Comportamento da propriedade:
- obrigatório para operações de criação
type integer Transporte usado pelo tipo de mídia.

Valores possíveis:
0 - E-mail;
1 - Script;
2 - SMS;
4 - Webhook.

Comportamento da propriedade:
- obrigatório para operações de criação
exec_path string Nome do arquivo de script (por exemplo, notification.sh) localizado no diretório especificado no parâmetro de configuração do server AlertScriptsPath.

Comportamento da propriedade:
- obrigatório se type estiver definido como "Script"
gsm_modem string Nome do dispositivo serial do modem GSM.

Comportamento da propriedade:
- obrigatório se type estiver definido como "SMS"
passwd string Senha de autenticação.

Comportamento da propriedade:
- suportado se smtp_authentication estiver definido como "Senha normal"
provider integer Provedor de e-mail.

Valores possíveis:
0 - (padrão) SMTP genérico;
1 - Gmail;
2 - Relay do Gmail;
3 - Office365;
4 - Relay do Office365.
smtp_email string Endereço de e-mail a partir do qual as notificações serão enviadas.

Comportamento da propriedade:
- obrigatório se type estiver definido como "E-mail"
smtp_helo string HELO do SMTP.

Comportamento da propriedade:
- suportado se type estiver definido como "E-mail"
smtp_server string server SMTP.

Comportamento da propriedade:
- obrigatório se type estiver definido como "E-mail"
smtp_port integer Porta do server SMTP à qual se conectar.

Padrão: 25.

Comportamento da propriedade:
- suportado se type estiver definido como "E-mail"
smtp_security integer Nível de segurança da conexão SMTP a ser usado.

Valores possíveis:
0 - (padrão) Nenhum;
1 - STARTTLS;
2 - SSL/TLS.

Comportamento da propriedade:
- suportado se type estiver definido como "E-mail"
smtp_verify_host integer Verificação SSL do host para SMTP.

Valores possíveis:
0 - (padrão) Não;
1 - Sim.

Comportamento da propriedade:
- suportado se smtp_security estiver definido como "STARTTLS" ou "SSL/TLS"
smtp_verify_peer integer Verificação SSL do peer para SMTP.

Valores possíveis:
0 - (padrão) Não;
1 - Sim.

Comportamento da propriedade:
- suportado se smtp_security estiver definido como "STARTTLS" ou "SSL/TLS"
smtp_authentication integer Método de autenticação SMTP a ser usado.

Valores possíveis:
0 - (padrão) Nenhum;
1 - Senha normal;
2 - Token OAuth.
A autenticação OAuth não é permitida para o provedor de e-mail Relay do Office365.

Comportamento da propriedade:
- suportado se type estiver definido como "E-mail"
redirection_url string URL do frontend do Zabbix para redirecionar de volta a autorização OAuth.

Padrão:
Valor da propriedade url das configurações da API com a parte zabbix.php?action=oauth.authorize

Comportamento da propriedade:
- obrigatório se smtp_authentication estiver definido como "Token OAuth"
client_id string Identificador do cliente registrado no server de autorização OAuth.

Comportamento da propriedade:
- obrigatório se smtp_authentication estiver definido como "Token OAuth"
client_secret string Segredo do cliente registrado no server de autorização OAuth. Acessível somente a usuários do tipo Super Admin.

Comportamento da propriedade:
- obrigatório se smtp_authentication estiver definido como "Token OAuth"
authorization_url string URL OAuth, com parâmetros, para obter tokens de acesso e de atualização.

Comportamento da propriedade:
- obrigatório se smtp_authentication estiver definido como "Token OAuth"
token_url string URL OAuth para trocar o token de autorização por tokens de acesso e de atualização.
Essa URL também é usada pelo server para atualizar um token de acesso inválido.

Comportamento da propriedade:
- obrigatório se smtp_authentication estiver definido como "Token OAuth"
tokens_status integer Máscara de bits do status dos tokens.

Valores possíveis:
0 - (padrão) Ambos os tokens contêm um valor inválido
1 - O token de acesso contém um valor válido
2 - O token de atualização contém um valor válido
3 - Ambos os tokens contêm valores válidos.

Comportamento da propriedade:
- suportado se smtp_authentication estiver definido como "Token OAuth"
access_token string Valor do token de acesso OAuth.

Comportamento da propriedade:
- obrigatório se smtp_authentication estiver definido como "Token OAuth"
access_token_updated timestamp Timestamp da última modificação de access_token feita pelo server durante a atualização com refresh_token ou pela API quando os tokens são alterados.

Comportamento da propriedade:
- suportado se smtp_authentication estiver definido como "Token OAuth"
access_expires_in integer Tempo, em segundos, até que access_token fique desatualizado e seja necessário fazer uma solicitação para refresh_url.
É definido pelo server do Zabbix durante a atualização de access_token ou pela API quando os tokens são alterados.

O timestamp é calculado adicionando o valor de access_token_updated.

Comportamento da propriedade:
- suportado se smtp_authentication estiver definido como "Token OAuth"
refresh_token string Valor do token de atualização OAuth.

Comportamento da propriedade:
- obrigatório se smtp_authentication estiver definido como "Token OAuth"
status integer Indica se o tipo de mídia está habilitado.

Valores possíveis:
0 - (padrão) Habilitado;
1 - Desabilitado.
username string Nome de usuário.

Comportamento da propriedade:
- suportado se smtp_authentication estiver definido como "Senha normal"
maxsessions integer Número máximo de alertas que podem ser processados em paralelo.

Valores possíveis se type estiver definido como "SMS": 1.

Valores possíveis se type estiver definido como "E-mail", "Script" ou "Webhook": 0-100.

Padrão: 1.
maxattempts integer Número máximo de tentativas para enviar um alerta.

Valores possíveis: 1-100.

Padrão: 3.
attempt_interval string Intervalo entre as tentativas novamente.
Aceita um número de segundos (por exemplo, 1, 30, 60) ou um valor com um sufixo de tempo (por exemplo, 30s, 1m, 1h).

Valores possíveis: 0-1h.

Padrão: 10s.
message_format integer Formato da mensagem.

Valores possíveis:
0 - Texto simples;
1 - (padrão) HTML.

Comportamento da propriedade:
- suportado se type estiver definido como "E-mail"
script text Corpo do script do Webhook (JavaScript).

Comportamento da propriedade:
- obrigatório se type estiver definido como "Webhook"
timeout string Tempo limite do script do Webhook.
Aceita um número de segundos (por exemplo, 1, 60) ou um valor com um sufixo de tempo (por exemplo, 30s, 1m)

Valores possíveis: 1-60s.

Padrão: 30s.

Comportamento da propriedade:
- suportado se type estiver definido como "Webhook"
process_tags integer Processa os valores das propriedades JSON na resposta do script do Webhook como tags. Essas tags são adicionadas a quaisquer tags de problema existentes.

Valores possíveis:
0 - (padrão) Ignorar a resposta do script do Webhook;
1 - Processar a resposta do script do Webhook como tags.

Comportamento da propriedade:
- suportado se type estiver definido como "Webhook"
show_event_menu integer Inclui uma entrada no menu de eventos que direciona para uma URL personalizada. Também adiciona a propriedade urls à saída de problem.get e event.get.

Valores possíveis:
0 - (padrão) Não incluir a entrada no menu de eventos nem a propriedade urls;
1 - Incluir a entrada no menu de eventos e a propriedade urls.

Comportamento da propriedade:
- suportado se type estiver definido como "Webhook"
event_menu_url string URL usada na entrada do menu de eventos e na propriedade urls retornada por problem.get e event.get.

Comportamento da propriedade:
- suportado se show_event_menu estiver definido como "Incluir a entrada no menu de eventos e a propriedade urls"
event_menu_name string Nome usado na entrada do menu de eventos e na propriedade urls retornada por problem.get e event.get.

Comportamento da propriedade:
- suportado se show_event_menu estiver definido como "Incluir a entrada no menu de eventos e a propriedade urls"
parameters array Parâmetros de Webhook ou de script.

Comportamento da propriedade:
- suportado se type estiver definido como "Webhook" ou "Script"
description text Descrição do tipo de mídia.

Parâmetros do webhook

Os parâmetros do webhook possuem as seguintes propriedades.

Propriedade Tipo Descrição
name string Nome do parâmetro.

Comportamento da propriedade:
- obrigatório
value string Valor do parâmetro, suporta macros.
As macros suportadas estão descritas na página Macros suportadas.

Parâmetros do script

Os parâmetros do script possuem as seguintes propriedades.

Propriedade Tipo Descrição
sortorder integer A ordem em que os valores dos parâmetros serão passados para o script como argumentos de linha de comando, começando com 0 como o primeiro.

Comportamento da propriedade:
- obrigatório
value string Valor do parâmetro, suporta macros.
As macros suportadas estão descritas na página Macros suportadas.

Modelo de mensagem

O objeto de modelo de mensagem define um modelo que será usado como mensagem padrão para operações de ação para enviar uma notificação. Ele possui as seguintes propriedades.

Propriedade Tipo Descrição
eventsource integer Fonte do evento.

Valores possíveis:
0 - Triggers;
1 - Descoberta;
2 - Autoregistro;
3 - Interno;
4 - Serviços.

Comportamento da propriedade:
- obrigatório
recovery integer Modo de operação.

Valores possíveis:
0 - Operações;
1 - Operações de recuperação;
2 - Operações de atualização.

Comportamento da propriedade:
- obrigatório
subject string Assunto da mensagem.
message string Texto da mensagem.