FAQ sur les notifications cloud
Questions générales
Qu’est-ce que le service Oracle Cloud Infrastructure Notifications ?
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.
Que puis-je faire avec ce service ?
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.
Comment fonctionne le service Notifications ?
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.
Comment commencer avec le service Notifications ?
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.
Comment le service Notifications se classe-t-il par rapport aux autres services de messagerie disponibles dans Oracle Cloud Infrastructure ?
Oracle Cloud Infrastructure offre les services de messagerie suivants pour la diffusion d’événements :
- Streaming
- Notifications
Bien que ces services présentent quelques similitudes, ils répondent à des cas d’utilisation distincts :
- Le cas d’utilisation le plus fréquent pour le service Notifications est d’envoyer des notifications aux abonnés inscrits et intéressés, et il est utilisé dans la programmation réactive. Ce service envoie des notifications à l’aide d’un modèle « Push », ce qui élimine la surcharge de l’interrogation périodique des mises à jour.
- Le cas d’utilisation le plus fréquent du service Streaming est l’ingestion de grandes quantités de données continues et leur mise à disposition immédiate pour consommation. Le service Streaming facilite l’ingestion, la rétention et la relecture rapide des données en continu. Contrairement au service Notifications, le service Streaming permet une relecture répétée des données stockées.
Concepts clés
Qu’est-ce qu’un sujet ?
Un sujet est un canal permettant de communiquer des messages à un abonnement.
Qu’est-ce qu’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 :
- E-mail : les messages sont envoyés à une adresse électronique spécifiée.
- HTTPS (PagerDuty) : les messages sont envoyés à PagerDuty.
- HTTPS (Webhook) : les messages sont envoyés au point de terminaison HTTPS.
- Slack : les messages sont envoyés à un canal Slack
- Oracle Functions : appel d'une fonction Oracle
- SMS : les messages sont envoyés à un numéro de téléphone compatible SMS
Qu’est-ce qu’un message ?
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.
Caractéristiques et fonctionnalités
Quelles fonctionnalités le service Notifications prend-il en charge ?
- Intégration de plusieurs points de terminaison et prise en charge de protocoles de messagerie tels que le courrier électronique et PagerDuty
- Évolutif avec un service entièrement géré qui garantit la durabilité des messages
- Logique de relance intelligente pour une remise effectuée au moins une fois
- Prise en charge de la sécurité pour la gestion des identités et des accès
- Gestion des abonnements
Quels protocoles de notification ce service prend-il actuellement en charge ?
Les notifications prennent en charge le courrier électronique, PagerDuty, Functions, HTTPS, Slack et SMS.
Quelles sont les opérations d’API disponibles via le service Notifications et où puis-je trouver de la documentation ?
Les opérations suivantes sont prises en charge avec davantage de documentation disponible ici :
- Utilisez ces opérations d’API pour gérer les sujets :
| 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é. |
- Utilisez ces opérations d’API pour gérer les abonnements :
| 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é. |
- Utilisez ces opérations d’API pour publier des messages :
| Opération | Description |
|---|---|
| publishMessage | Publie un message vers le sujet spécifié. |
Quelle est la durabilité des messages après leur publication vers un sujet ?
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.
Le service Notifications conserve-t-il les messages ?
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.
Le service Notifications abandonne-t-il un message lorsque celui-ci atteint sa durée de rétention maximale ?
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.
Combien de fois un destinataire reçoit-il une notification ?
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.
Puis-je publier les mêmes messages vers plusieurs points de terminaison via un seul sujet ?
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.
Les messages sont-ils remis dans l’ordre exact de leur publication vers un sujet ?
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.
Les abonnés peuvent-ils recevoir uniquement un sous-ensemble de messages publiés vers un sujet ?
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.
Puis-je supprimer un message après sa publication vers un sujet ?
Vous ne pouvez pas supprimer un message après sa publication vers un sujet du service Notifications.
Puis-je changer l’objet et le nom de l’expéditeur des e-mails envoyés par le 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.
Opérations et dépannage
Quel indicateurs clés puis-je utiliser pour la surveillance du service Notifications ?
- Voici les principaux indicateurs clés que vous pouvez utiliser :
| 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é. |
Comment suis-je notifié de l’échec d’une notification ?
Vous pouvez configurer une alarme sur l’indicateur NumberOfNotificationFailed via le service Monitoring. Pour en savoir plus, cliquez ici.
Que se passe-t-il si je publie des messages vers un sujet dépourvu d’abonnements ?
L’opération de publication réussit, mais les messages sont abandonnés car aucun abonnement ne s’y intéresse.
Le service Notifications conserve-t-il les messages ?
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.
Que se passe-t-il si un abonné n’est pas disponible ?
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.
Sécurité
Qui peut créer un sujet ?
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.
Qui peut publier des messages vers un sujet ?
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.
Plusieurs éditeurs peuvent-ils publier vers un même sujet ?
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.
Qui peut s’abonner à un sujet ?
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.
Comment un propriétaire de sujet donne-t-il accès aux abonnés ?
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.
Qui peut confirmer ou refuser un abonnement ?
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.
Comment le service Notifications peut-il s’assurer qu’un éditeur ne peut pas envoyer de spam à un point de terminaison d’abonnement et que les messages sont envoyés uniquement aux abonnés valides, enregistrés et intéressés ?
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é.
- Dès qu’un administrateur de locataires ou un propriétaire de sujet ajoute un utilisateur de point de terminaison, le service Notifications envoie un message de confirmation à cet abonné.
- Après réception du message de confirmation au point de terminaison, l’abonné confirme la demande d’abonnement en envoyant une réponse valide. Ce n’est qu’alors que le service Notifications considère la demande d’abonnement comme valide. En cas d’absence de réponse, le service n’envoie aucune notification à ce point de terminaison.
Comment le service Notifications authentifie-t-il les appels d’API ?
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.
Comment un abonné peut-il se désabonner des messages ?
Un abonné peut se désabonner d’un sujet du service Notifications des manières suivantes :
- En utilisant la console ou l’opération d’API DeleteSubscription
- (Pour les abonnés par e-mail uniquement) En utilisant l’option de désabonnement dans le corps des e-mails envoyés par le service Notifications
Limites et restrictions
Quelles sont les limites du service Notifications ?
- Veuillez noter que les limites du service Notifications sont définies au niveau régional.
| 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. | ||
- Les autres limites sont les suivantes :
| 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 |
Quel est le coût du service Notifications ?
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 propose-t-il un niveau gratuit ?
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.
Étapes suivantes
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.