Documentation Oracle Cloud Infrastructure

Gestion des messages

Découvrez comment publier, utiliser et gérer des messages dans une file d'attente.

Exemple de flux de file d'attente

Le schéma suivant est un exemple dans lequel l'émetteur envoie un message à une file d'attente et deux destinataires tentent de traiter ce message.

Schéma représentant la génération, la mise à jour, l'utilisation et la suppression d'un message.

  1. Un émetteur envoie un message à la file d'attente avec la durée de conservation des messages par défaut.

    Il reçoit une confirmation indiquant que le service Queue a reçu et stocké le message.

  2. Le destinataire A tente de recevoir le message.

    Le consommateur A reçoit le message qu'il est censé traiter dans le délai d'expiration de visibilité A.

  3. Le destinataire B tente de recevoir un message.

    Le consommateur B ne reçoit rien, car le seul message disponible a déjà été consommé par le consommateur A.

  4. Le destinataire A ne parvient pas à traiter le message dans le temps imparti par le délai d'expiration de visibilité A, et met donc à jour le message pour prolonger le délai d'expiration de visibilité.
  5. Le destinataire B tente de nouveau de recevoir un message.

    Le consommateur B ne reçoit rien, car le seul message disponible a été consommé et étendu par le consommateur A.

  6. Le délai d'expiration de visibilité prolongé s'écoule.
  7. Le destinataire B tente de recevoir un message une troisième fois.

    Le consommateur B reçoit le message qu'il est censé traiter dans le délai d'expiration de visibilité B.

  8. Le consommateur A tente de recevoir le message, mais ne reçoit rien, car le consommateur B a consommé le message.

    Le destinataire A ne peut plus prolonger le délai d'expiration de visibilité du message ni supprimer le message.

  9. Le destinataire B traite le message et tente de le supprimer de la file d'attente.

    Le consommateur B reçoit une confirmation indiquant que le message a été supprimé définitivement. Il ne peut donc être transmis à aucun autre consommateur.

Remarque

Chaque fois qu'un message est distribué à un destinataire, la valeur du champ Nombre de distributions du message est incrémentée. Lorsque le nombre de livraisons d'un message atteint le maximum configuré, il est envoyé à une file d'attente de lettres mortes.

Adresse de messages

Pour générer des messages vers une file d'attente ou utiliser des messages d'une file d'attente, vous devez connaître l'adresse de messages employée par cette file d'attente. L'adresse des messages d'une file d'attente ressemble à ce qui suit :

https://cell-1.queue.messaging.<region>.oci.oraclecloud.com

Pour trouver l'adresse des messages d'une file d'attente :

  1. Sur la page de liste Files d'attente, sélectionnez la file d'attente à utiliser. Si vous avez besoin d'aide pour rechercher la page de liste ou la file d'attente, reportez-vous à la rubrique Liste des files d'attente.

    La section Informations sur la file d'attente contient l'adresse de messages.

Vous pouvez rechercher l'adresse de messages à l'aide de l'API avec une demande GetQueue.

Stratégie IAM requise

Afin d'obtenir des détails sur les droits d'accès requis pour la gestion des files d'attente, reportez-vous à Stratégies Queue et à Exemples de stratégie.

Etapes suivantes