Aperçu du service d'avis

Le service d'avis permet de configurer des canaux de communication pour la publication de messages à l'aide de sujets et d'abonnements. Lorsqu'un message est publié pour un sujet, le service d'avis envoie le message à tous les abonnés au sujet.

Lorsqu'un point d'extrémité d'abonné n'accuse pas réception d'un message, le service d'avis renvoie le message. Ce cas peut survenir lorsque le point d'extrémité est hors ligne. Par exemple, le serveur de courriel pour une adresse de courriel peut-être arrêté.

Pour modifier la durée des nouvelles tentatives d'un abonnement, voir Mise à jour d'un abonnement.

Voici une description des concepts de base relatifs aux avis.

formatage convivial

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

Protocoles d'abonnement pris en charge :

• Courriel

Types de message pris en charge :

• Messages d'alarme (lorsque le service d'avis est la destination)

  Voir Exemples de message d'alarme et Mise à jour d'une alarme après le déplacement d'une ressource.

• Messages de connecteur (lorsque le service d'avis est le service cible)

  Voir Exemples de messages de connecteur et Mise à jour d'un connecteur pour utiliser des formats conviviaux.

message

Contenu publié pour un sujet. Chaque message est transmis au moins une fois par abonnement. Chaque message envoyé sous forme de courriel contient un lien pour se désabonner du sujet associé.

avis

Configuration pour l'envoi de messages, par exemple une alarme ou une règle d'événement. Chaque message est envoyé aux abonnements au sujet spécifié.

Il existe plusieurs types d'avis :

• Avis contextuel : Créé à partir d'un modèle de démarrage rapide ou d'options ciblées pertinentes pour la ressource indiquée.

  Pour obtenir des instructions sur une instance de calcul, voir Configuration d'avis contextuels pour une instance.

• Avis traditionnel : Créé à partir d'un point d'intégration pris en charge.

  Voici des exemples de scénarios pour les avis traditionnels : redimensionnement automatique des machines virtuelles, envoi de messages d'alarme à Slack et par SMS et déclaration de tickets Jira pour des rappels.

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

abonnement

Point d'extrémité pour un sujet. Les messages publiés sont envoyés à chaque abonné au sujet.

Protocoles d'abonnement pris en charge :

• Adresse de courriel :

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

  Note
  
  Suivez les meilleures pratiques pour l'intégration au service de transmission de messages. Voir Conserver une réputation d'expéditeur de courriel positive.

  Le contenu et l'apparence des messages varient en fonction du type de message. Voir Messages d'alarme, Événements et Messages de connecteur.

  Certains types de message utilisent le formatage convivial.

• Fonction :
  exécute la fonction spécifiée lorsque vous publiez un message pour le sujet parent de l'abonnement. Par exemple, exécute une fonction pour redimensionner des 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 spécifié 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 à la section Messages d'alarme, à la section Messages d'événement et à la section Messages de connecteur.
• SMS :
  Envoie un message texte à l'aide du service SMS au numéro de téléphone spécifié lorsque vous publiez un message dans le sujet parent de l'abonnement. Formats de point d'extrémité pris en charge : format E.164.

  Note
  
  

  Les SMS internationaux sont requis si les SMS proviennent d'un numéro de téléphone d'un autre pays. Nous ajoutons continuellement la prise en charge de nouveaux pays afin que davantage d'utilisateurs puissent recevoir des messages SMS à partir de numéros de téléphone locaux.

  Les abonnements SMS ne sont activés que pour les messages envoyés par les services Oracle Cloud Infrastructure suivants : Annonces, Surveillance et Centre de connecteurs. Les messages SMS envoyés par des services non pris en charge sont supprimés. Voir Cause : Ressource non prise en charge utilisée pour les SMS.

  Le service d'avis fournit des messages SMS à partir d'un groupe de nombres préconfiguré. Vous pouvez recevoir des messages SMS de plusieurs numéros.

  Le contenu et l'apparence des messages varient en fonction du type de message. Voir Messages d'alarme par SMS et messages de connecteur par SMS.

  Pays et régions disponibles

  Vous pouvez utiliser les avis pour envoyer des messages SMS aux pays et aux 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
  France	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
  États-Unis	AE
  Royaume-Uni	GB
  États-Unis	US

sujet

Canal de communication pour l'envoi de messages aux abonnements. Chaque nom de sujet est unique dans la location.

Les ressources publient des messages vers le sujet configuré. Le service d'avis transmet les messages aux abonnements actifs dans le sujet.

Les ressources qui peuvent envoyer des messages incluent des alarmes, des abonnements aux annonces, des règles d'événement, des connecteurs et des avis contextuels (alarmes et règles d'événement). (Un utilisateur, un service ou une application peut également envoyer un message au moyen de la publication directe.)

Par exemple, considérez une alarme configurée pour envoyer des messages à un sujet. Cette rubrique contient des 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. Le service d'avis transmet 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é. Le service d'avis transmet le message aux abonnements de courriel et de SMS, car il s'agit des seuls abonnements actifs du sujet.

Pour les mesures de suivi des messages publiés et livrés, voir Mesures disponibles : oci_notification.

Alarmes

Lorsque la règle de déclenchement d'une alarme est violée, l'alarme envoie un message d'alarme au sujet configuré. Le service d'avis transmet ensuite le message aux abonnements actifs dans ce sujet. Voir Gestion des alarmes.

Un avis contextuel peut inclure une alarme.

Abonnements aux annonces

Un abonnement aux annonces envoie des messages d'annonce de la console au sujet configuré. Le service d'avis transmet ensuite le message aux abonnements actifs dans ce sujet.

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é. Le service d'avis transmet ensuite le message aux abonnements actifs dans ce sujet. Voir Gestion des règles pour les événements.

Un avis contextuel peut inclure une règle d'événement.

Connecteurs

Un connecteur envoie un message de connecteur au sujet configuré. Le service d'avis transmet ensuite le message aux abonnements actifs dans ce sujet. Voir Gestion des connecteurs.

Publication directe

Un utilisateur (ou un service ou une application) envoie un message au sujet configuré. Le service d'avis transmet ensuite le message aux abonnements actifs dans ce sujet. Voir Publication d'un message pour un sujet.

Le service Avis est disponible dans toutes les régions commerciales d'Oracle Cloud Infrastructure. Voir À propos des régions et des domaines de disponibilité pour consulter la liste des régions disponibles, ainsi que les emplacements, identificateurs de région, clés de région et domaines de disponibilité associés.

Pour décider si vous devez utiliser le service d'avis ou le service de courriel pour envoyer vos messages, tenez compte des caractéristiques décrites ci-après; Pour plus d'informations sur le service Transmission de messages, voir Aperçu du service de transmission de messages.

La plupart des types de ressource Oracle Cloud Infrastructure ont un identificateur unique affecté par Oracle, appelé identificateur Oracle Cloud (OCID). Pour des informations sur le format des OCID et sur les autres moyens d'identifier vos ressources, voir Identificateurs de ressource.

Vous pouvez accéder au service d'avis au moyen de la console ou de l'API REST d'avis. Les instructions relatives à la console, à l'interface CLI et à l'API sont incluses dans ce guide. Pour obtenir une liste des trousses SDK disponibles, voir Trousses SDK et interface de ligne de commande.

Console : Pour accéder au service Avis à l'aide de la console, vous devez utiliser un navigateur pris en charge. Pour accéder à la page de connexion de la console, ouvrez le menu de navigation en haut de cette page et sélectionnez Console Infrastructure. Vous êtes invité à entrer votre location Oracle Cloud, votre nom d'utilisateur et votre mot de passe. Ouvrez le menu de navigation et sélectionnez Services de développement. Sous Intégration d'applications, sélectionnez Avis.

API : Pour accéder au service Avis au moyen d'une API, utilisez l'API du service Avis.

Interface de ligne de commande : Voir Informations de référence sur la ligne de commande pour le service d'avis.

Administrateurs : Pour les politiques communes qui donnent aux groupes l'accès aux ressources du service d'avis, voir Politiques IAM (dans la page Sécurisation des avis).

Pour une liste des limites applicables et des instructions pour demander l'augmentation d'une limite, voir Limites de service. Pour définir des limites propres à un compartiment pour une ressource ou une famille de ressources, les administrateurs peuvent utiliser des quotas de compartiment.