Documentation sur Oracle Cloud Infrastructure

Utilisation de messages à partir d'un canal

Voyez comment consommer des messages à partir d'un canal ou de canaux spécifiques dans une file d'attente.

La consommation de messages nécessite des autorisations pour la file d'attente et l'accès à son point d'extrémité pour les messages. Pour plus d'informations, voir Consommation de messages et Canaux.

Vous pouvez spécifier un canal particulier à partir duquel consommer les messages. Pour plus d'informations sur le filtrage, voir Sélection de message.

Note

Si des messages ont été publiés pour un canal, mais qu'une demande de consommation n'inclut pas de canal, les messages sont retournés d'un canal aléatoire avec les messages disponibles de la file d'attente spécifiée.

  • Vous ne pouvez pas utiliser la console pour consommer des messages, mais vous pouvez utiliser la console pour rechercher des messages. La scrutation des messages permet un aperçu de la file d'attente ou du canal. Les messages scrutés par la console ne sont pas disponibles pour d'autres consommateurs tant que la temporisation de visibilité n'a pas expiré.

    1. Dans la page de liste Files d'attente, sélectionnez la file d'attente avec laquelle vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou la file d'attente, voir Liste des files d'attente.
    2. Dans la page des détails de la file d'attente, sélectionnez Canaux.
    3. (Facultatif) Sélectionnez Gérer les paramètres de scrutation. Fournissez les informations suivantes, puis cliquez sur enregistrer les modifications :
      • Temporisation de scrutation (secondes) : Temps d'attente avant la consommation des messages.
      • Nombre de messages dans une demande : Nombre maximal de messages à consommer lors de la scrutation.
    4. Sélectionnez Poll aléatoire channel (Polluer un canal aléatoire) ou sélectionnez le menu Actions (Menu Actions) pour un canal spécifique et sélectionnez Poll message (Polluer un message).
    5. Sélectionnez Continuer.

      Si les messages sont disponibles pour consommation, ils s'affichent dans le panneau Poll channel messages (Polluer les messages du canal), avec le nom de la file d'attente et l'ID 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 à partir d'un canal. Pour consommer des messages à partir d'un canal spécifique, incluez channel-filter. Par exemple :

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

    Pour la liste complète des paramètres et valeurs des commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface.

  • Utilisez l'opération GetMessages pour consommer des messages à partir d'un canal. Une demande GetMessages contient un paramètre limit facultatif, un paramètre visibilityInSeconds facultatif et un paramètre timeoutInSeconds facultatif.

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

    Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir la documentation de l'API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.