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 sélectionnez Mettre à jour :
      • 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 Sondage du canal aléatoire ou sélectionnez le menu Actions (trois points) pour un canal spécifique, puis sélectionnez Sondage du message.
    5. Sélectionnez Continuer.

      Si les messages sont disponibles pour consommation, ils sont affichés dans le panneau Sondage des messages de canal, ainsi que le nom de la file d'attente et l'ID canal.

    6. Pour plus de détails sur un message, sélectionnez le menu Actions (trois points), puis sélectionnez Voir les détails du 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 des valeurs pour les commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface de ligne de commande.

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