Objet type de média

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

Type de média

L’objet de 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é :
- en 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 - E-mail ;
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 électronique.

Valeurs possibles :
0 - (par défaut) SMTP générique ;
1 - Gmail ;
2 - Relais Gmail ;
3 - Office365 ;
4 - Relais Office365.
smtp_email string Adresse e-mail à 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.

Valeur 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 la 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 SSL de l’hôte 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 SSL de l’homologue 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 Relais Office365.

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

Valeur par défaut :
Valeur de la propriété url des paramètres de l’API 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é auprès du 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é auprès du serveur d’autorisation OAuth. Accessible uniquement aux utilisateurs de type Super administrateur.

Comportement de la propriété :
- obligatoire si smtp_authentication est défini sur « OAuth token »
authorization_url string URL OAuth, avec les paramètres permettant d’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 permettant d’é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 non valide.

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

Valeurs possibles :
0 - (par défaut) Les deux jetons contiennent une valeur non valide ;
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 de modifications du 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’une requête vers refresh_url soit nécessaire.
Cette valeur est définie par le serveur Zabbix lors de l’actualisation de access_token ou par l’API lors de modifications du 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.

Valeur possible si type est défini sur « SMS » : 1.

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

Valeur par défaut : 1.
maxattempts integer Nombre maximal de tentatives d’envoi d’une alerte.

Valeurs possibles : 1-100.

Valeur par défaut : 3.
attempt_interval string Intervalle entre les tentatives successives.
Accepte un nombre de secondes (par exemple, 1, 30, 60) ou une valeur avec un suffixe temporel (par exemple, 30s, 1m, 1h).

Valeurs possibles : 0-1h.

Valeur 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 un nombre de secondes (par exemple, 1, 60) ou une valeur avec un suffixe temporel (par exemple, 30s, 1m).

Valeurs possibles : 1-60s.

Valeur par défaut : 30s.

Comportement de la propriété :
- pris en charge si type est défini sur « Webhook »
process_tags integer Traite les valeurs des propriétés JSON de la réponse du script Webhook comme des tags. Ces tags sont ajoutés aux 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 Inclut une entrée dans le menu des événements qui renvoie 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 des événements ni la propriété urls ;
1 - Inclure l’entrée du menu des événements 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 des événements 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 « Inclure l’entrée du menu des événements et la propriété urls »
event_menu_name string Nom utilisé pour l’entrée du menu des événements 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 « Inclure l’entrée du menu des événements et la propriété urls »
parameters array Paramètres de Webhook ou de 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 ont 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.