Simple Message Queue (formerly MNS):Prise en main des topics

Prérequis

Activer Simple Message Queue (anciennement MNS) et accorder des permissions

Créer une file d'attente

1. Connectez-vous à la console Simple Message Queue (anciennement MNS).

2. Dans le volet de navigation de gauche, choisissez Queue Model > Queues.

3. Dans la barre de navigation supérieure, sélectionnez une région.

4. Sur la page Queues, cliquez sur Create Queue.

5. Dans le panneau Create Queue, configurez les paramètres suivants et cliquez sur OK.

   • Name : nom de la file d'attente.

   • Queue Type : sélectionnez un type de file d'attente.

     • Standard Queue : permet d'envoyer et de consommer des messages standards. L'ordre de consommation n'est pas garanti.

     • FIFO Queue : garantit que les messages appartenant au même groupe sont consommés dans l'ordre où ils ont été envoyés.

   • Maximum Message Length : longueur maximale du corps d'un message pouvant être envoyé à la file d'attente.

   • Long Polling Period : durée maximale pendant laquelle une requête ReceiveMessage attend si aucun message n'est disponible dans la file d'attente. Si vous définissez ce paramètre sur 0, le Long Polling est désactivé. Si vous lui attribuez une valeur non nulle, le Long Polling est activé.

   • Visibility Timeout Period : période pendant laquelle un message reste à l'état Inactif après avoir été récupéré de la file d'attente. Pour plus d'informations, consultez la rubrique Visibilité des messages.

   • Message Retention Period : durée de conservation maximale d'un message dans la file d'attente. Passé ce délai, le message est supprimé, qu'il ait été récupéré ou non.

   • Message Delay Period : délai d'attente avant qu'un message envoyé à la file d'attente ne puisse être consommé.

   • Enable Logging Feature : indique s'il faut activer la gestion des journaux. Si vous activez cette fonctionnalité, les journaux d'opérations de cette file d'attente sont automatiquement poussés vers le Logstore spécifié. Vous pouvez consulter les traces de messages, la latence et d'autres informations dans les journaux. Pour plus d'informations, consultez la rubrique Gestion des journaux.

   La file d'attente est créée et apparaît sur la page Queues.

Créer un topic

1. Connectez-vous à la console Simple Message Queue (anciennement MNS).

2. Dans le volet de navigation de gauche, choisissez Topic Model > Topics.

3. Dans la barre de navigation supérieure, sélectionnez une région.

4. Sur la page Topics, cliquez sur Create Topic.

5. Dans le panneau Create Topic, configurez les paramètres suivants et cliquez sur OK.

   • Name : nom du topic.

   • Topic Type : sélectionnez un type de topic.

     • Standard Topic : permet d'envoyer et de consommer des messages standards. L'ordre de consommation n'est pas garanti.

     • FIFO Topic : garantit que les messages appartenant au même groupe sont consommés dans l'ordre où ils ont été envoyés.

   • Maximum Message Length : longueur maximale du corps d'un message pouvant être envoyé au topic.

   • Enable Logging Feature : indique s'il faut activer la gestion des journaux. Si vous activez cette fonctionnalité, les journaux d'opérations de ce topic sont automatiquement poussés vers le Logstore spécifié. Vous pouvez consulter les traces de messages, la latence et d'autres informations dans les journaux. Pour plus d'informations, consultez la rubrique Gestion des journaux.

   La page Topic Details du topic s'affiche.

Créer un abonnement

Créez un abonnement pour pousser les messages du topic vers une file d'attente.

1. Sur la page Topics, localisez le topic et, dans la colonne Actions, cliquez sur View Subscriptions.

2. Dans le panneau View Subscriptions For Topic, cliquez sur l'onglet Subscriptions.

3. Sur la page Subscriptions, cliquez sur Create Subscription.

4. Dans le panneau Create Subscription, configurez les paramètres suivants et cliquez sur OK.

   • Name : nom de l'abonnement.

   • Subscription : type de push. Par défaut : HTTP.

   • Receiver Endpoint : endpoint pour la livraison des messages.

   • Facultatif : Message Filtering Tag : tag permettant de filtrer les messages.

   • Retry Policy : politique de nouvelle tentative en cas d'échec du push de messages.

     Politiques de nouvelle tentative disponibles :

     • Nouvelle tentative avec backoff

     • Nouvelle tentative à décroissance exponentielle

   • Message Format : format des messages poussés vers l'endpoint.

     Formats de message disponibles :

     • SIMPLIFIED

     • JSON

     • XML

   L'abonnement est créé et apparaît sur la page Subscriptions.

Publier un message

Publiez un message sur un topic. Le message est poussé vers la file d'attente abonnée.

1. Sur la page Topics, localisez le topic et, dans la colonne Actions, cliquez sur Publish Message.

2. Sur la page Publish Message To Topic, configurez les paramètres suivants et cliquez sur Publish Message.

   • Message Content : corps du message à publier.

   • (Facultatif) Message Tag : tag permettant de filtrer les messages.

   • Subscription Type : type d'abonnement cible. Cet exemple utilise une file d'attente.

   Le message « Message sent successfully » s'affiche.

Recevoir un message

Récupérez le message publié depuis la file d'attente pour vérifier sa livraison.

1. Sur la page Queues, localisez la file d'attente et, dans la colonne Action, choisissez More > Send Messages.

2. Facultatif : Sur la page Send/Receive Messages For Queue, dans la section Receive Message, cliquez sur Edit Parameters of Receiving Messages. Dans le panneau Edit Parameters of Receiving Messages, configurez les paramètres Receive Times et Polling Period, puis cliquez sur OK.

3. Sur la page Send/Receive Messages For Queue, dans la section Receive Message, cliquez sur Receive Message.

   Les messages de la file d'attente apparaissent dans la section Receive Message.

4. Facultatif : Dans la liste des messages, localisez le message et, dans la colonne Actions, cliquez sur Details. Dans la boîte de dialogue Message Details, consultez le corps du message et d'autres informations.

Supprimer la file d'attente

1. Sur la page Queues, localisez la file d'attente et, dans la colonne Actions, choisissez More > Delete.

2. Dans la boîte de dialogue Prompt, lisez les informations et cliquez sur OK.

   La file d'attente est supprimée de la page Queues.

Supprimer le topic

1. Sur la page Topics, localisez le topic et, dans la colonne Actions, choisissez More > Delete.

2. Dans la boîte de dialogue Prompt, lisez les informations et cliquez sur OK.

   Le topic est supprimé de la page Topic List.

   Avertissement

   La suppression d'un topic entraîne la suppression définitive de toutes ses données.