Oracle Cloud Infrastructureドキュメント

キューからのメッセージの使用

キューからメッセージをコンシュームします。

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

キューにチャネルがある場合、チャネルIDのない消費リクエストは、キューまたはそのチャネルのいずれかからメッセージを返します。

注意

ポーリングにより、メッセージの配信数の値が増加します。デッド・レター・キューの設定に応じて、ポーリングはキューまたはチャネルからメッセージを削除し、デッド・レター・キューまたはチャネルに送信できます。

  • コンソールを使用してメッセージを消費することはできませんが、それを使用してメッセージをポーリングすることはできません。メッセージのポーリングは、キューの閲覧として機能します。コンソールによってポーリングされたメッセージは、表示タイムアウトが経過するまで他のコンシューマでは使用できません。

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

      メッセージが消費可能な場合は、「メッセージ」表に表示されます。メッセージは、キューまたはそのチャネルの1つからランダムにポーリングされます。チャネルからのメッセージは、チャネルIDとともに表示されます。

  • oci queue messages get-messagesコマンドおよび必須パラメータを使用して、キューからメッセージを消費します:

    oci queue messages get-messages --queue-id <queue_OCID>

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

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

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