Objet type de média

Les objets suivants sont directement liés à l'API mediatype.

Type de média

L'objet type de média possède les propriétés suivantes.

Propriété Type Description
mediatypeid ID ID du type de média.

Comportement de la propriété :
- lecture seule
- obligatoire pour les opérations de mise à jour
name string Nom du type de média.

Comportement de la propriété :
- obligatoire pour les opérations de création
type integer Transport utilisé par le type de média.

Valeurs possibles :
0 - Email ;
1 - Script ;
2 - SMS ;
4 - Webhook.

Comportement de la propriété :
- obligatoire pour les opérations de création
exec_path string Nom du fichier de script (par exemple, notification.sh) situé dans le répertoire spécifié dans le paramètre de configuration du serveur AlertScriptsPath.

Comportement de la propriété :
- obligatoire si type est défini sur "Script"
gsm_modem string Nom du périphérique série du modem GSM.

Comportement de la propriété :
- obligatoire si type est défini sur "SMS"
passwd string Mot de passe d'authentification.

Comportement de la propriété :
- pris en charge si smtp_authentication est défini sur "Normal password"
provider integer Fournisseur de messagerie.

Valeurs possibles :
0 - (par défaut) SMTP générique ;
1 - Gmail ;
2 - Relais Gmail ;
3 - Office365 ;
4 - Relais Office365.
smtp_email string Adresse email à partir de laquelle les notifications seront envoyées.

Comportement de la propriété :
- obligatoire si type est défini sur "Email"
smtp_helo string HELO SMTP.

Comportement de la propriété :
- pris en charge si type est défini sur "Email"
smtp_server string Serveur SMTP.

Comportement de la propriété :
- obligatoire si type est défini sur "Email"
smtp_port integer Port du serveur SMTP auquel se connecter.

Par défaut : 25.

Comportement de la propriété :
- pris en charge si type est défini sur "Email"
smtp_security integer Niveau de sécurité de connexion SMTP à utiliser.

Valeurs possibles :
0 - (par défaut) Aucun ;
1 - STARTTLS ;
2 - SSL/TLS.

Comportement de la propriété :
- pris en charge si type est défini sur "Email"
smtp_verify_host integer Vérification de l'hôte SSL pour SMTP.

Valeurs possibles :
0 - (par défaut) Non ;
1 - Oui.

Comportement de la propriété :
- pris en charge si smtp_security est défini sur "STARTTLS" ou "SSL/TLS"
smtp_verify_peer integer Vérification du pair SSL pour SMTP.

Valeurs possibles :
0 - (par défaut) Non ;
1 - Oui.

Comportement de la propriété :
- pris en charge si smtp_security est défini sur "STARTTLS" ou "SSL/TLS"
smtp_authentication integer Méthode d'authentification SMTP à utiliser.

Valeurs possibles :
0 - (par défaut) Aucune ;
1 - Mot de passe normal ;
2 - Jeton OAuth.
L'authentification OAuth n'est pas autorisée pour le fournisseur de messagerie Office365 relay.

Comportement de la propriété :
- pris en charge si type est défini sur "Email"
redirection_url string URL du frontend Zabbix vers laquelle rediriger après l'autorisation OAuth.

Par défaut :
Valeur de la propriété des paramètres de l'API url avec la partie zabbix.php?action=oauth.authorize

Comportement de la propriété :
- obligatoire si smtp_authentication est défini sur "OAuth token"
client_id string Identifiant client enregistré dans le serveur d'autorisation OAuth.

Comportement de la propriété :
- obligatoire si smtp_authentication est défini sur "OAuth token"
client_secret string Secret client enregistré dans le serveur d'autorisation OAuth. Accessible uniquement pour un utilisateur de type Super Admin.

Comportement de la propriété :
- obligatoire si smtp_authentication est défini sur "OAuth token"
authorization_url string URL OAuth, avec paramètres, pour obtenir les jetons d'accès et d'actualisation.

Comportement de la propriété :
- obligatoire si smtp_authentication est défini sur "OAuth token"
token_url string URL OAuth pour échanger le jeton d'autorisation contre des jetons d'accès et d'actualisation.
Cette URL est également utilisée par le serveur pour actualiser un jeton d'accès invalide.

Comportement de la propriété :
- obligatoire si smtp_authentication est défini sur "OAuth token"
tokens_status integer Masque de bits de l'état des jetons.

Valeurs possibles :
0 - (par défaut) Les deux jetons contiennent une valeur invalide
1 - Le jeton d'accès contient une valeur valide
2 - Le jeton d'actualisation contient une valeur valide
3 - Les deux jetons contiennent une valeur valide.

Comportement de la propriété :
- pris en charge si smtp_authentication est défini sur "OAuth token"
access_token string Valeur du jeton d'accès OAuth.

Comportement de la propriété :
- obligatoire si smtp_authentication est défini sur "OAuth token"
access_token_updated timestamp Horodatage de la dernière modification de access_token effectuée par le serveur lors de l'actualisation avec refresh_token ou par l'API lors des modifications de jeton.

Comportement de la propriété :
- pris en charge si smtp_authentication est défini sur "OAuth token"
access_expires_in integer Durée en secondes avant que access_token n'expire et qu'il soit nécessaire d'effectuer une requête vers refresh_url.
Elle est définie par le serveur Zabbix lors de l'actualisation de access_token ou par l'API lors des modifications de jeton.

L'horodatage est calculé en ajoutant la valeur de access_token_updated.

Comportement de la propriété :
- pris en charge si smtp_authentication est défini sur "OAuth token"
refresh_token string Valeur du jeton d'actualisation OAuth.

Comportement de la propriété :
- obligatoire si smtp_authentication est défini sur "OAuth token"
status integer Indique si le type de média est activé.

Valeurs possibles :
0 - (par défaut) Activé ;
1 - Désactivé.
username string Nom d'utilisateur.

Comportement de la propriété :
- pris en charge si smtp_authentication est défini sur "Normal password"
maxsessions integer Nombre maximal d'alertes pouvant être traitées en parallèle.

Valeurs possibles si type est défini sur "SMS" : 1.

Valeurs possibles si type est défini sur "Email", "Script" ou "Webhook" : 0-100.

Par défaut : 1.
maxattempts integer Nombre maximal de tentatives d'envoi d'une alerte.

Valeurs possibles : 1-100.

Par défaut : 3.
attempt_interval string Intervalle entre les tentatives de nouvelle tentative.
Accepte les secondes et une unité de temps avec suffixe.

Valeurs possibles : 0-1h.

Par défaut : 10s.
message_format integer Format du message.

Valeurs possibles :
0 - Texte brut ;
1 - (par défaut) HTML.

Comportement de la propriété :
- pris en charge si type est défini sur "Email"
script text Corps du script Webhook (JavaScript).

Comportement de la propriété :
- obligatoire si type est défini sur "Webhook"
timeout string Délai d'expiration du script Webhook.
Accepte les secondes et une unité de temps avec suffixe.

Valeurs possibles : 1-60s.

Par défaut : 30s.

Comportement de la propriété :
- pris en charge si type est défini sur "Webhook"
process_tags integer Traiter les valeurs des propriétés JSON dans la réponse du script Webhook comme des tags. Ces tags sont ajoutés à tous les tags de problème existants.

Valeurs possibles :
0 - (par défaut) Ignorer la réponse du script webhook ;
1 - Traiter la réponse du script webhook comme des tags.

Comportement de la propriété :
- pris en charge si type est défini sur "Webhook"
show_event_menu integer Inclure une entrée dans le menu d'événement qui pointe vers une URL personnalisée. Ajoute également la propriété urls à la sortie de problem.get et event.get.

Valeurs possibles :
0 - (par défaut) Ne pas inclure l'entrée du menu d'événement ni la propriété urls ;
1 - Inclure l'entrée du menu d'événement et la propriété urls.

Comportement de la propriété :
- pris en charge si type est défini sur "Webhook"
event_menu_url string URL utilisée dans l'entrée du menu d'événement et dans la propriété urls renvoyée par problem.get et event.get.

Comportement de la propriété :
- pris en charge si show_event_menu est défini sur "Include event menu entry and urls property"
event_menu_name string Nom utilisé pour l'entrée du menu d'événement et dans la propriété urls renvoyée par problem.get et event.get.

Comportement de la propriété :
- pris en charge si show_event_menu est défini sur "Include event menu entry and urls property"
parameters array Paramètres du Webhook ou du script.

Comportement de la propriété :
- pris en charge si type est défini sur "Webhook" ou "Script"
description text Description du type de média.

Paramètres du webhook

Les paramètres du webhook possèdent les propriétés suivantes.

Propriété Type Description
name string Nom du paramètre.

Comportement de la propriété :
- obligatoire
value string Valeur du paramètre, prend en charge les macros.
Les macros prises en charge sont décrites sur la page Macros prises en charge.

Paramètres du script

Les paramètres du script ont les propriétés suivantes.

Propriété Type Description
sortorder integer L’ordre dans lequel les valeurs des paramètres seront transmises au script en tant qu’arguments de ligne de commande, en commençant par 0 comme premier argument.

Comportement de la propriété :
- obligatoire
value string Valeur du paramètre, prend en charge les macros.
Les macros prises en charge sont décrites sur la page Macros prises en charge.

Modèle de message

L'objet modèle de message définit un modèle qui sera utilisé comme message par défaut pour les opérations d'action afin d'envoyer une notification. Il possède les propriétés suivantes.

Propriété Type Description
eventsource integer Source de l'événement.

Valeurs possibles :
0 - Déclencheurs ;
1 - Découverte ;
2 - Enregistrement automatique ;
3 - Interne ;
4 - Services.

Comportement de la propriété :
- obligatoire
recovery integer Mode de fonctionnement.

Valeurs possibles :
0 - Opérations ;
1 - Opérations de récupération ;
2 - Opérations de mise à jour.

Comportement de la propriété :
- obligatoire
subject string Sujet du message.
message string Texte du message.