Documentation Oracle Cloud Infrastructure

Utiliser des messages d'une file d'attente

Consommer des messages à partir d'une file d'attente.

L'utilisation des messages nécessite des droits d'accès à la file d'attente et un accès à son adresse de messages. Pour plus d'informations, reportez-vous à Consommation de messages.

Si la file d'attente comporte des canaux, une demande de consommation sans ID de canal renvoie les messages de la file d'attente ou de l'un de ses canaux.

Attention

L'interrogation augmente la valeur du nombre de distributions pour le message. Selon les paramètres de la file d'attente des lettres mortes, l'interrogation peut supprimer le message d'une file d'attente ou d'un canal et l'envoyer à une file d'attente ou un canal de lettres mortes.

  • Vous ne pouvez pas utiliser la console pour utiliser des messages, mais vous pouvez l'utiliser pour rechercher des messages. L'interrogation des messages permet d'avoir un aperçu de la file d'attente. Les messages interrogés par la console ne sont pas disponibles pour les autres destinataires tant que le délai d'expiration de visibilité ne s'est pas écoulé.

    1. Sur la page de liste Files d'attente, sélectionnez la file d'attente à utiliser. Si vous avez besoin d'aide pour trouver la page de liste ou la file d'attente, reportez-vous à Liste des files d'attente.
    2. Sur la page de détails de la file d'attente, sélectionnez Messages.
    3. (Facultatif) Sélectionnez Gérer les paramètres d'interrogation. Fournissez les informations suivantes, puis sélectionnez Mettre à jour :
      • Délai d'expiration de l'interrogation (secondes) : temps d'attente des messages à utiliser.
      • Nombre de messages dans une demande : nombre maximal de messages à utiliser lors de l'interrogation.
    4. Sélectionnez Rechercher les messages.
    5. Sélectionnez Continuer.

      Si des messages sont disponibles pour utilisation, ils sont affichés dans la table Messages. Les messages sont interrogés de manière aléatoire à partir de la file d'attente ou de l'un de ses canaux. Les messages d'un canal sont affichés avec leur ID de canal.

  • Utilisez la commande oci queue messages get-messages et les paramètres requis pour consommer les messages d'une file d'attente :

    oci queue messages get-messages --queue-id <queue_OCID>

    Pour obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à Référence des commandes de la CLI.

  • Utilisez l'opération GetMessages pour consommer des messages. Une demande GetMessages contient les paramètres facultatifs limit, visibilityInSeconds et timeoutInSeconds.

    Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à la documentation relative à l'API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.