Présentation de Notifications

Le service Notifications permet de configurer des canaux de communication pour la publication de messages à l'aide de sujets  et d'abonnements . Lorsqu'un message est publié dans un sujet, le service Notifications envoie le message à l'ensemble des abonnements du sujet.

Lorsque l'adresse d'un abonné n'accuse pas réception du message, le service Notifications effectue une nouvelle tentative de distribution. Cette situation peut survenir lorsque l'adresse est hors connexion. Par exemple, le serveur de messagerie pour une adresse électronique peut être arrêté.

Pour modifier la durée des nouvelles tentatives d'abonnement, reportez-vous à Mise à jour de la stratégie de transmission d'un abonnement.

Les concepts suivants sont essentiels pour une bonne utilisation du service Notifications.

formatage convivial

Paramètre permettant d'améliorer la lisibilité humaine des messages.

Protocoles d'abonnement pris en charge :

• Courriel

Types de message pris en charge :

• Messages d'alarme (lorsque Notifications est la destination)

  Reportez-vous aux sections alarm message examples et Updating an Alarm After Moving a Resource.

• Messages de connecteur (lorsque Notifications est le service cible)

  Reportez-vous à Exemples de message de connecteur et à Mise à jour d'un connecteur pour l'utilisation de formats conviviaux.

message

Il s'agit du contenu publié dans une rubrique. Chaque message est distribué au moins une fois par abonnement. Chaque message envoyé sous forme de courriel contient un lien permettant de se désabonner de la rubrique associée.

notification

Configuration pour l'envoi de messages, telle qu'une règle d'alarme ou d'événement. Chaque message est envoyé à des abonnements de la rubrique indiquée.

Les types de notification suivants sont disponibles :

• Notification contextuelle : créée à partir d'un modèle de démarrage rapide ou d'options ciblées pertinentes pour la ressource donnée.

  Pour obtenir des instructions sur l'utilisation d'une instance de calcul, reportez-vous à Configuration de notifications contextuelles pour une instance.

• Notification traditionnelle : créée à partir d'un point d'intégration pris en charge.

  Les exemples de scénarios pour les notifications traditionnelles incluent le redimensionnement automatique des machines virtuelles, l'envoi de messages d'alarme à Slack et SMS et le dépôt de tickets Jira pour les rappels.

Après avoir créé la notification, vous pouvez la gérer comme d'habitude. Par exemple, si la notification est une alarme, gérez-la à l'aide de la page Alarmes de la console.

abonnement

Adresse d'une rubrique. Les messages publiés sont envoyés à chaque abonnement pour une rubrique.

Protocoles d'abonnement pris en charge :

• Adresse électronique :

  Envoie un courriel lorsque vous publiez un message  dans le sujet  parent de l'abonnement.

  Remarque
  
  Suivez les meilleures pratiques d'intégration à Email Delivery. Reportez-vous à Maintien d'une réputation d'expéditeur de courriels positive et à Configuration de domaines personnalisés pour les courriels.

  Le contenu et l'apparence des messages varient en fonction du type de message. Reportez-vous aux Messages d'alarme, aux Messages d'événement et aux Messages de connecteur.

  Certains types de message utilisent le formatage convivial.

• Fonction :
  Exécute la fonction spécifiée lorsque vous publiez un message  dans le sujet parent de l'abonnement. Par exemple, exécute une fonction permettant de redimensionner les machines virtuelles lorsqu'une alarme associée est déclenchée.
• HTTPS (URL personnalisée) :

  Envoie les informations spécifiées lorsque vous publiez un message  dans le sujet  parent de l'abonnement.

• PagerDuty:
  Crée un incident PagerDuty par défaut lorsque vous publiez un message  dans le sujet  parent de l'abonnement.
• Slack :
  Envoie un message au canal Slack indiqué par défaut lorsque vous publiez un message  dans le sujet  parent de l'abonnement.

  Le contenu et l'apparence des messages varient en fonction du type de message. Reportez-vous aux Messages d'alarme, aux Messages d'événement et aux Messages de connecteur.
• SMS :
  Envoie un message texte à l'aide du service SMS au numéro de téléphone indiqué lorsque vous publiez un message dans le sujet parent de l'abonnement. Formats d'adresse pris en charge : format E.164.

  Remarque
  
  

  Des fonctionnalités SMS internationales sont requises si les messages SMS proviennent d'un numéro de téléphone d'un autre pays. Nous étendons continuellement la prise en charge à davantage de pays afin qu'un plus grand nombre d'utilisateurs puissent recevoir des messages SMS de numéros de téléphone locaux.

  Les abonnements à SMS sont activés uniquement pour les messages envoyés par les services Oracle Cloud Infrastructure suivants : Announcements, Monitoring et Connector Hub. Les messages SMS envoyés par des services non pris en charge sont supprimés. Reportez-vous à Cause : ressource non prise en charge utilisée pour les SMS.

  Le service Notifications distribue des messages SMS à partir d'un pool préconfiguré de numéros. Vous pouvez recevoir des messages SMS provenant de plusieurs numéros.

  Le contenu et l'apparence des messages varient en fonction du type de message. Reportez-vous aux messages d'alarme SMS et aux messages de connecteur SMS.

  Pays et régions disponibles

  Vous pouvez utiliser Notifications pour envoyer des messages SMS aux pays et régions suivants :

  Pays ou région	Code ISO
  Australie	AU
  Brésil	BR
  Canada	CA
  Chili	CL
  Chine	CN
  Costa Rica	CR
  Croatie	HR
  République tchèque	CZ
  Français	FR
  Allemagne	DE
  Hongrie	HU
  Inde	IN
  Irlande	IE
  Israël	IL
  Japon	JP
  Lituanie	LT
  Mexique	MX
  Pays-Bas	NL
  Nouvelle-Zélande	NZ
  Norvège	NO
  Philippines	PH
  Pologne	PL
  Portugal	PT
  Roumanie	RO
  Arabie saoudite	SA
  Singapour	SG
  Afrique du Sud	ZA
  Corée du Sud	KR
  Espagne	ES
  Suède	SE
  Suisse	CH
  Ukraine	UA
  Emirats arabes unis	AE
  Royaume-Uni	GB
  Etats-Unis	US

sujet

Canal de communication utilisé pour l'envoi de messages à des abonnements. Chaque nom de sujet est unique dans la location.

Les messages de publication des ressources vers le sujet configuré. Notifications fournit ensuite des messages aux abonnements actifs dans la rubrique.

Les ressources pouvant envoyer des messages incluent des alarmes, des abonnements d'annonce, des règles d'événement, des connecteurs et des notifications contextuelles (alarmes et règles d'événement). (Un utilisateur, un service ou une application peut également envoyer un message via une publication directe.)

Par exemple, prenons une alarme configurée pour envoyer des messages à un sujet. Cette rubrique contient les abonnements par courriel, Slack et SMS. Lorsque la règle de déclenchement d'alarme est enfreinte, l'alarme publie un message sur le sujet. Notifications remet ensuite le message aux abonnements actifs du sujet. Dans cet exemple, l'abonnement Slack est en attente car il n'a pas encore été confirmé. Notifications distribue le message aux abonnements de type courriel et SMS uniquement, car il s'agit des seuls abonnements actifs du sujet.

Pour obtenir des mesures qui assurent le suivi des messages publiés et distribués, reportez-vous à Mesures disponibles : oci_notification.

Alarmes

En cas de violation de la règle de déclencheur d'une alarme , l'alarme envoie un message d'alarme au sujet configuré. Notifications transmet ensuite le message aux abonnements actifs de cette rubrique. Reportez-vous à Gestion des alarmes.

Une notification contextuelle peut inclure une alarme.

Abonnements d'annonce

Un abonnement d'annonce envoie des messages d'annonce de la console au sujet configuré. Notifications transmet ensuite le message aux abonnements actifs de cette rubrique.

Règles d'événement

Lorsqu'elle est déclenchée, une règle d'événement envoie un message d'événement au sujet configuré. Notifications transmet ensuite le message aux abonnements actifs de cette rubrique. Reportez-vous à Gestion des règles pour Events.

Une notification contextuelle peut inclure une règle d'événement.

Connecteurs

Un connecteur envoie un message de connecteur au sujet configuré. Notifications transmet ensuite le message aux abonnements actifs de cette rubrique. Reportez-vous à Gestion des connecteurs.

Publication directe

Un utilisateur (ou un service ou une application) envoie un message au sujet configuré. Notifications transmet ensuite le message aux abonnements actifs de cette rubrique. Reportez-vous à Publication d'un message dans un sujet.

Le service Notifications est disponible dans toutes les régions commerciales Oracle Cloud Infrastructure. Reportez-vous à A propos des régions et des domaines de disponibilité pour obtenir la liste des régions disponibles, ainsi que les emplacements associés, les identificateurs de région, les clés de région et les domaines de disponibilité.

Afin de choisir entre le service Notifications ou le service Email Delivery pour envoyer vos courriels, tenez compte des fonctionnalités suivantes. Pour plus d'informations sur Email Delivery, reportez-vous à Présentation du service Email Delivery.

La plupart des types de ressource Oracle Cloud Infrastructure ont un identificateur unique affecté par Oracle appelé ID Oracle Cloud (OCID). Pour plus d'informations sur le format OCID et d'autres façons d'identifier vos ressources, reportez-vous à Identificateurs de ressource.

Vous pouvez accéder au service Notifications à l'aide de la console ou de l'API REST Notifications. Les instructions relatives à la console, à l'interface de ligne de commande et à l'API sont incluses dans ce guide. Pour obtenir la liste des kits SDK disponibles, reportez-vous à Kits SDK et interface de ligne de commande.

Console : pour accéder à Notifications à l'aide de la console, vous devez utiliser un navigateur pris en charge. Pour accéder à la page de connexion à la console, ouvrez le menu de navigation en haut de cette page et cliquez sur Console Infrastructure. Vous êtes invité à saisir votre locataire cloud, votre nom utilisateur et votre mot de passe. Ouvrez le menu de navigation et cliquez sur Services de développeur. Sous Intégration d'application, cliquez sur Notifications.

API : pour accéder à Notifications via l'API, utilisez l'API Notifications.

Interface de ligne de commande : reportez-vous à Référence de ligne de commande pour Notifications.

Administrateurs : pour connaître les stratégies courantes qui permettent aux groupes d'accéder aux ressources Notifications, reportez-vous à Stratégies IAM (sur la page Sécuriser Notifications).

Pour obtenir la liste des limites applicables et des instructions permettant de demander une augmentation de limite, reportez-vous à Limites de service. Pour définir des limites propres aux compartiments sur une ressource ou une famille de ressources, les administrateurs peuvent utiliser des quotas de compartiment.