すべてのプロダクト
Search
ドキュメントセンター

Simple Message Queue (formerly MNS):トピックベースのメッセージングの使用開始

最終更新日:Jan 13, 2025

このトピックでは、Simple Message Queue (旧称 MNS) コンソールでトピックベースのメッセージングの使用を開始する方法について説明します。

前提条件

SMQ がアクティブ化されており、RAM ユーザーが SMQ にアクセスする権限を持っていること。詳細については、「SMQ をアクティブ化し、RAM ユーザーに SMQ へのアクセスを承認する」をご参照ください。

SMQ キューの作成

  1. [SMQ コンソール] にログオンします。

  2. 左側のナビゲーションペインで、[キューモデル] > キュー を選択します。

  3. 上部のナビゲーションバーで、リージョンを選択します。

  4. キュー ページで、キューを作成 をクリックします。

  5. [キューの作成] パネルで、次のパラメーターを設定し、[OK] をクリックします。

    • 名前: キューの名前。

    • メッセージの最大長さ: キューに送信されるメッセージの最大本文長。

    • ロングポーリング期間: ReceiveMessage オペレーションが呼び出された後、ロングポーリングリクエストが保持される最大期間。

    • メッセージの可視性タイムアウト時間: キューからメッセージが受信された後、メッセージが非アクティブ状態のままになる期間。

    • メッセージの保持期間: メッセージがキューに存在する最大期間。指定された保持期間が経過すると、メッセージが受信されているかどうかに関係なく、メッセージは削除されます。

    • メッセージ遅延時間: キューに送信されたすべてのメッセージが消費されるまでの期間。

    • ログ機能の有効化: ロギング機能を有効にするかどうかを指定します。

    キューは キュー ページに表示されます。

トピックの作成

  1. [SMQ コンソール] にログオンします。

  2. 左側のナビゲーションペインで、[トピックモデル] > トピック を選択します。

  3. 上部のナビゲーションバーで、リージョンを選択します。

  4. トピック ページで、トピックの作成 をクリックします。

  5. トピックの作成 パネルで、次のパラメーターを設定し、[OK] をクリックします。

    • 名前: トピックの名前。

    • メッセージの最大長さ: トピックに送信されるメッセージの最大本文長。

    • ログ機能の有効化: ロギング機能を有効にするかどうかを指定します。

    トピックを作成すると、トピックの詳細 ページが表示されます。

サブスクリプションの作成

トピックのサブスクリプションを作成できます。こうすることで、トピックに送信されたメッセージは、トピックをサブスクライブしているキューにプッシュされます。

  1. トピック ページで、表示するトピックを見つけ、購読を見る[アクション] 列の をクリックします。

  2. [トピックへのサブスクリプションの表示] パネルで、サブスクリプションリスト をクリックします。

  3. サブスクリプションリスト ページで、購読の作成 をクリックします。

  4. 購読の作成 パネルで、次のパラメーターを設定し、[OK] をクリックします。

    • 名前: サブスクリプションの名前。

    • サブスクリプションタイプ: サブスクリプションのタイプ。デフォルト値は HTTP です。

    • 受信側エンドポイント: レシーバーのエンドポイント。

    • (オプション) メッセージのフィルタリングタグ: メッセージのフィルタリングに使用されるタグ。

    • 再試行ポリシー: SMQ トピックから受信者へのメッセージ配信中にエラーが発生した場合に適用される再試行ポリシーです。

      有効な値:

      • バックオフ再試行

      • 指数関数的減衰再試行

    • メッセージ形式: レシーバーにプッシュされるメッセージの形式です。

      有効な値:

      • SIMPLIFIED

      • JSON

      • XML

    サブスクリプションは サブスクリプションリスト ページに表示されます。

メッセージのパブリッシュ

トピックにメッセージをパブリッシュし、次にそのメッセージをトピックをサブスクライブしているキューにプッシュできます。

  1. トピック ページで、トピックを見つけ、メッセージのパブリッシュ[アクション] 列の をクリックします。

  2. [トピックへのメッセージのパブリッシュを試す] ページで、次のパラメーターを設定し、メッセージのパブリッシュ をクリックします。

    • メッセージ内容: メッセージの本文。

    • (オプション) メッセージタグ: メッセージのフィルタリングに使用されるタグ。

    • 購読タイプ: メッセージのサブスクリプションタイプ。この例では、メッセージはキューにプッシュされます。

    ページに「メッセージが送信されました」と表示されます。

メッセージの受信

メッセージがキューにパブリッシュされた後、キューからメッセージを受信できます。次に、メッセージコンテンツを確認して、パブリッシュされたメッセージと受信されたメッセージが同じであることを確認できます。このトピックでは、SMQ コンソールで、トピックの指定されたキューにプッシュされたメッセージを受信する方法について説明します。

  1. キュー ページで、キューを見つけ、その他 > メッセージの送受信アクション 列の を選択します。

  2. オプション。 メッセージの受信 セクションの [クイックエクスペリエンス] ページで、受信メッセージパラメータの編集 をクリックします。受信メッセージパラメータの編集 パネルで、一回に取得できる最大メッセージ数 パラメーターと ポーリング期間 パラメーターを設定し、[OK] をクリックします。

  3. メッセージの受信 セクションの [クイックエクスペリエンス] ページで、メッセージを受信 をクリックします。

    メッセージの一覧が メッセージの受信 セクションに表示されます。

  4. オプション。 メッセージリストからメッセージを見つけ、詳細情報[アクション] 列でクリックします。メッセージの詳細 ダイアログボックスで、メッセージの内容とその他の情報を表示します。

キューの削除

  1. キュー ページで、削除するキューを見つけ、その他 > 削除[アクション] 列の を選択します。

  2. [メモ] メッセージで、メモを読み、[OK] をクリックします。

    キューは、キュー ページから削除されます。

トピックの削除

  1. トピック ページで、削除するトピックを見つけ、その他 > 削除[アクション] 列の を選択します。

  2. [メモ] メッセージで、メモを読み、[OK] をクリックします。

    トピックは、[トピック] ページから削除されます。

    警告

    トピックが削除されると、トピックのデータを復元することはできません。