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 à Consommation de 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 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 Canaux.
    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 Poll random channel ou Actions (trois points) pour un canal spécifique, puis sélectionnez Message d'interrogation.
    5. Sélectionnez Continuer.

      Si des messages sont disponibles pour utilisation, ils sont affichés dans le panneau Messages de canal d'interrogation avec le nom de la file d'attente et l'ID du canal.

    6. Pour obtenir plus de détails sur un message, sélectionnez le menu Actions (trois points), puis Afficher les détails du 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 de la CLI, reportez-vous à Référence des commandes de la CLI.

  • 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.