Oracle Cloud Infrastructure Notifications est un service de publication-abonnement entièrement géré qui envoie des messages à plusieurs points de terminaison d’abonnement à grande échelle. Les notifications prennent en charge les notifications de type « push » vers des points de terminaison tels que l’e-mail, PagerDuty, Functions, HTTPS, Slack et SMS, ainsi que la prise en charge intégrée d’Oracle Cloud Infrastructure Monitoring et de Service Connector Hub.
Le cas d’utilisation le plus courant des notifications sera de prendre en charge les messages de surveillance et le Service Connector Hub pour envoyer des alertes d’application. Vous pouvez, par exemple, configurer les alarmes Oracle Cloud Infrastructure Monitoring pour envoyer des notifications en fonction d’un sujet. Lorsque vous vous abonnez à ce sujet en utilisant soit la messagerie électronique, soit PagerDuty, vous êtes immédiatement informé des anomalies dans votre infrastructure cloud. Une autre mise en œuvre consiste à utiliser l’intégration de notre protocole de messagerie pour permettre au service Notifications d’envoyer des messages au nom de vos services à des abonnés spécifiés. Pour les cas d’utilisation allant de la réinitialisation de mot de passe aux rappels de calendrier et même aux coups de pouce au panier d’achat, le service Notifications fournit la flexibilité nécessaire pour découpler les services avec la prise en charge des protocoles et des intégrations tierces les plus populaires.
Le service Notifications utilise un cadre de publication-abonnement dans lequel les éditeurs de messages sont découplés des abonnés du message. Vous configurez des canaux de communication pour publier des messages par l’intermédiaire de sujets et d’abonnements. Un sujet est un canal permettant de communiquer des messages à un abonnement. Un abonnement est un point de terminaison pour un protocole pris en charge. Lorsqu’un message est publié dans un sujet, le service envoie le message à tous les abonnements du sujet.
Vous pouvez accéder au service Notifications par l’intermédiaire de la console (une interface basée sur un navigateur) ou de l’API REST ou de la CLI. Pour obtenir la liste des SDK disponibles, consultez les kits de développement logiciel et l’interface de ligne de commande.
Oracle Cloud Infrastructure offre les services de messagerie suivants pour la diffusion d’événements :
Bien que ces services présentent quelques similitudes, ils répondent à des cas d’utilisation distincts :
Un sujet est un canal permettant de communiquer des messages à un abonnement.
Un abonnement est un point de terminaison pour un sujet. Les messages publiés sont envoyés à chaque abonnement pour un sujet particulier. Les protocoles d’abonnement suivants sont actuellement pris en charge :
Le contenu publié vers un sujet. Chaque message est remis au moins une fois par abonnement. Chaque message envoyé par e-mail contient un lien pour se désinscrire du sujet connexe.
Les notifications prennent en charge le courrier électronique, PagerDuty, Functions, HTTPS, Slack et SMS.
Les opérations suivantes sont prises en charge avec davantage de documentation disponible ici :
Opération | Description |
---|---|
createTopic | Crée un sujet dans le compartiment spécifié. |
getTopic | Récupère les informations de configuration du sujet spécifié. |
listTopics | Répertorie les sujets dans le compartiment spécifié. |
updateTopic | Met à jour la configuration du sujet spécifié. |
deleteTopic | Supprime le sujet spécifié. |
Opération | Description |
---|---|
createSubscription | Crée un abonnement pour le sujet spécifié. |
deleteSubscription | Supprime l’abonnement spécifié. |
listSubscriptions | Répertorie les abonnements dans le compartiment ou le sujet spécifié. |
getSubscription | Récupère les informations de configuration de l’abonnement spécifié. |
updateSubscription | Met à jour la configuration de l’abonnement spécifié. |
getConfirmSubscription | Obtient les détails de confirmation de l’abonnement spécifié. |
resendSubscriptionConfirmation | Renvoie les détails de confirmation de l’abonnement spécifié. |
getUnsubscription | Obtient les détails de confirmation du désabonnement spécifié. |
Opération | Description |
---|---|
publishMessage | Publie un message vers le sujet spécifié. |
Tous les messages qui sont publiés dans un sujet de notification sont durables dans la région. Lorsqu’un message est publié vers un sujet, le message est répliqué de manière synchrone dans trois domaines de disponibilité au sein d’une région avant qu’un accusé de réception soit envoyé à l’éditeur du message.
Lorsque le point de terminaison d’un abonné n’accuse pas réception d’un message, le service tente à nouveau la diffusion et conserve actuellement le message jusqu’à deux heures à compter de la publication du message vers un sujet. Le service tente de remettre des messages dans le cadre de la fenêtre de rétention.
Oui, Le service Notifications abandonne un message lorsque celui-ci atteint sa durée de conservation maximale, qui est de deux heures, que le message ait été remis ou non.
Le service Notifications remet des messages au moins une fois à un point de terminaison d’abonnement. Avec ces mises en œuvre, une duplication peut parfois se produire et il est recommandé que le récepteur gère toutes les notifications dupliquées.
Vous pouvez configurer le service Notifications de sorte à remettre des messages à plusieurs points de terminaison d’un même sujet. Par exemple, vous pouvez envoyer une alarme Oracle Cloud Infrastructure Monitoring à une adresse e-mail et/ou au point de terminaison PagerDuty en même temps.
Le service Notifications remet les messages de l’éditeur dans l’ordre dans lequel ils sont publiés vers un sujet. Cependant, en raison de la nature des partitions réseau, de la stabilité de la connexion Internet et de l’échec transitoire, le service Notifications peut délivrer des messages dans un autre ordre.
Actuellement, tous les messages publiés vers un sujet sont remis à tous les points de terminaison d’abonnement de ce sujet. Les abonnés ne peuvent pas s’abonner de manière sélective à un sous-ensemble de messages.
Vous ne pouvez pas supprimer un message après sa publication vers un sujet du service Notifications.
Vous pouvez modifier la ligne d’objet de chaque message en faisant passer l’objet pour un paramètre dans l’opération d’API PublishMessage. Actuellement, vous ne pouvez pas modifier le nom d’expéditeur par défaut des e-mails envoyés par le service Notifications.
Nom de l’indicateur | Description |
---|---|
Nombre de messages publiés | Le nombre de messages publiés vers le service Notifications. |
Nombre de messages remis | Le nombre de messages remis avec succès. |
Nombre de messages en échec | Le nombre de messages qui n’ont pas été remis. |
Taille des messages publiés (octets) | La taille totale des messages publiés. |
Taille des messages remis (octets) | La taille totale des messages remis avec succès. |
Taille des messages en échec (octets) | La taille totale des messages dont la remise a échoué. |
Vous pouvez configurer une alarme sur l’indicateur NumberOfNotificationFailed via le service Monitoring. Pour en savoir plus, cliquez ici.
L’opération de publication réussit, mais les messages sont abandonnés car aucun abonnement ne s’y intéresse.
Lorsque le point de terminaison d’un abonné n’accuse pas réception d’un message, le service tente à nouveau la diffusion et conserve actuellement le message jusqu’à deux heures à compter de la publication du message vers un sujet. Le service tente de remettre des messages dans le cadre de la fenêtre de rétention.
Si le service Notifications ne reçoit pas l’accusé de réception d’un point de terminaison d’abonnement, le service essaie de remettre à nouveau les messages pendant un maximum de deux heures. Cette situation peut se produire lorsque le point de terminaison est hors ligne. Par exemple, le service PagerDuty peut être hors ligne.
Par défaut, les administrateurs de locataires Oracle Cloud Infrastructure sont autorisés à créer des sujets. Cependant, les administrateurs de locataires peuvent accorder des autorisations et définir des stratégies pour permettre également à des groupes d’utilisateurs de créer des sujets. Pour de plus amples informations, voir la section Pour commencer avec les stratégies. Pour des détails spécifiques sur la rédaction de stratégies pour chacun des différents services, voir la section Références sur les stratégies. Pour les stratégies courantes qui permettent aux groupes d’accéder au service Notifications, voir aussi les sections Autoriser un groupe à gérer les sujets, Autoriser un groupe à gérer les abonnements aux sujets et Autoriser un groupe à publier des messages vers des sujets.
Par défaut, le propriétaire du sujet est autorisé à publier des messages, mais d’autres utilisateurs Oracle Cloud Infrastructure peuvent se voir accorder des autorisations. Reportez-vous à la procédure d'autorisation de publication de messages sur des sujets pour un groupe.
Un propriétaire de sujet peut définir des autorisations explicites pour autoriser plusieurs utilisateurs ou locataires à publier vers un sujet. Par défaut, seuls les propriétaires de sujets sont autorisés à publier vers un sujet. Pour ajuster vos stratégies, découvrez-en plus dans la section Autoriser un groupe à publier des messages vers des sujets.
Les abonnés peuvent être ajoutés par l’administrateur de locataires ou le propriétaire du sujet. Reportez-vous aux sections Stratégies de Notifications et Gestion des abonnements pour davantage d’informations.
Le propriétaire du sujet peut accorder aux abonnés l’autorisation de s’abonner à un sujet. Pour davantage d’informations, reportez-vous à la section Stratégies communes pour la publication des notifications.
Pour les e-mails, les abonnés reçoivent une URL de confirmation d’abonnement une fois que leur ajout est effectif. Pour en savoir plus sur la confirmation d’abonnement et le renvoi des détails de la confirmation, cliquez ici.
Pour garantir qu’un point de terminaison d’abonné ne peut pas être spammé et que les messages sont envoyés uniquement à des points de terminaison valides et enregistrés, le service Notifications a besoin de l’adhésion explicite d’un abonné.
L’authentification du service Notifications est intégrée au service Oracle Cloud Infrastructure Identity and Access Management (IAM). Pour en savoir plus, cliquez ici.
Un abonné peut se désabonner d’un sujet du service Notifications des manières suivantes :
Ressource | Crédits universels mensuels | Pay-as-You-Go (paiement à l’utilisation) ou promotionnel |
---|---|---|
Thématiques | 50 (actifs ou en création*) par location | Nous contacter |
Abonnements | 10 (actifs ou en attente*) par sujet 100 (en attente*) par location |
Nous contacter |
Pour bénéficier de sujets/d’abonnements supplémentaires, veuillez nous contacter pour augmenter les limites. |
Article | Taille |
---|---|
Taille du message par requête | 64 Ko |
Protocole | Messages par minute vers un seul point de terminaison |
---|---|
60 | |
HTTPS (téléavertissement) | 10 |
La tarification du service Notifications est simple et intuitive. Les clients paient par remise de message. Pour HTTPS, les clients paient 0,60 USD par million de messages par mois. Pour les e-mails, les clients paient 0,02 USD par 1 000 e-mails envoyés par mois. Pour les SMS, les clients paient par SMS en fonction du pays de destination.
Le service Notifications introduit un niveau qui permet aux clients Oracle Cloud Infrastructure de démarrer gratuitement. Chaque mois, les clients peuvent diffuser un million de messages aux points de terminaison HTTPS et 1 000 e-mails sans aucun frais.
Si le service Notifications ne reçoit pas l’accusé de réception d’un point de terminaison d’abonnement, le service essaie de remettre à nouveau les messages pendant un maximum de deux heures. Cette situation peut se produire lorsque le point de terminaison est hors ligne. Par exemple, le service PagerDuty peut être hors ligne.