チャネルからのメッセージの消費

キュー内の特定のチャネルからメッセージを消費する方法を学習します。

メッセージの消費には、キューに対する権限と、そのメッセージ・エンドポイントへのアクセスが必要です。詳細は、メッセージの消費およびチャネルを参照してください。

メッセージの消費元の特定のチャネルを指定できます。フィルタリングの詳細は、「メッセージの選択」を参照してください。

ノート

メッセージがチャネルにパブリッシュされたが、消費リクエストにチャネルが含まれていない場合、メッセージはランダム・チャネルから返され、指定されたキューから使用可能なメッセージが送信されます。
  • コンソールを使用してメッセージを消費することはできませんが、コンソールを使用してメッセージをポーリングすることはできません。メッセージのポーリングは、キューまたはチャネルの確認として機能します。コンソールによってポーリングされたメッセージは、表示タイムアウトが経過するまで他のコンシューマでは使用できません。

    1. 「キュー」リスト・ページで、操作するキューを選択します。リスト・ページまたはキューの検索に関するヘルプが必要な場合は、キューのリストを参照してください。
    2. キューの詳細ページで、「チャネル」を選択します。
    3. (オプション)「ポーリング設定の管理」を選択します。次の情報を指定して、「変更の保存」をクリックします:
      • ポーリング・タイムアウト(秒): メッセージが消費されるまで待機する時間の長さ。
      • リクエスト内のメッセージ数: ポーリング時に消費するメッセージの最大数。
    4. 「ランダム・チャネルのポーリング」を選択するか、特定のチャネルの「アクション」メニュー(アクション・メニュー)を選択し、「メッセージのポーリング」を選択します。
    5. 「続行」を選択します。

      メッセージが使用可能な場合は、「ポーリング・チャネル・メッセージ」パネルに、キューの名前およびチャネルIDとともに表示されます。

    6. メッセージを選択して、メッセージの詳細を取得します。
  • oci queue messages get-messagesコマンドおよび必須パラメータを使用して、チャネルからメッセージを消費します。特定のチャネルからメッセージを消費するには、channel-filterを含めます。たとえば、次のとおりです。

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

    CLIコマンドのパラメータおよび値のリストは、CLIコマンド・リファレンスを参照してください。

  • GetMessages操作を使用して、チャネルからメッセージを消費します。GetMessagesリクエストには、オプションのlimit、オプションのvisibilityInSecondsおよびオプションのtimeoutInSecondsパラメータが含まれます。

    特定のチャネルからメッセージを消費するには、channelFilterパラメータを含めます。

    APIの使用およびリクエストの署名の詳細は、REST APIのドキュメントおよびセキュリティ資格証明を参照してください。SDKの詳細は、SDKおよびCLIを参照してください。