Documentation Oracle Cloud Infrastructure

Utilisation de messages provenant d'un canal

Découvrez comment utiliser les messages d'un canal ou de canaux spécifiques dans 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 à Utilisation des messages et à Canaux.

Vous pouvez indiquer un canal particulier à partir duquel utiliser les messages. Pour plus d'informations sur le filtrage, reportez-vous à Sélection de message.

Remarque

Si des messages ont été publiés sur un canal, mais qu'une demande de consommation n'inclut pas de canal, les messages sont renvoyés à partir d'un canal aléatoire contenant les messages disponibles de la file d'attente indiquée.

  • 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 ou du canal. 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 rechercher la page de liste ou la file d'attente, reportez-vous à la rubrique Liste des files d'attente.
    2. Sur la page de détails de la file d'attente, sélectionnez Canaux.
    3. (Facultatif) Sélectionnez Gérer les paramètres d'interrogation. Fournissez les informations suivantes, puis cliquez sur Enregistrer les modifications :
      • 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 Interroger un canal aléatoire ou sélectionnez le menu Actions (Menu Actions) d'un canal spécifique et sélectionnez Interroger le message.
    5. Sélectionnez Continuer.

      Si des messages sont disponibles pour la consommation, ils s'affichent dans le panneau Interroger les messages du canal avec le nom de la file d'attente et l'ID du canal.

    6. Sélectionnez un message pour obtenir plus de détails sur un message.

  • Utilisez la commande oci queue messages get-messages et les paramètres requis pour consommer les messages d'un canal. Pour consommer des messages à partir d'un canal spécifique, incluez channel-filter. Exemples :

    oci queue messages get-messages --queue-id <queue_OCID> --channel-filter <channel_ID>

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

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

    Pour consommer des messages provenant de canaux particuliers, incluez le paramètre channelFilter.

    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.