ApsaraMQ for MQTT SDK を使用してメッセージを送受信する前に、ApsaraMQ for MQTT コンソールで、インスタンス、トピック、グループなどの関連リソースを作成する必要があります。各リソースは、ご利用のクライアント構成のパラメーターにマッピングされます。
前提条件
開始する前に、以下を確認してください。
ステップ 1: インスタンスの作成
インスタンスは、トピックとグループをホストし、SDK クライアントが接続するエンドポイントを提供する仮想マシンです。
ApsaraMQ for MQTT コンソールにログインします。左側のナビゲーションウィンドウで、[Instances] をクリックします。
トップナビゲーションバーでリージョンを選択します。左上隅の[Create Instance] をクリックします。
表示されるパネルで、デフォルトの [サブスクリプション] 課金方法をそのままにして、[OK] をクリックします。
購入ページで、要件に基づいてインスタンスの仕様を選択し、サービス利用規約に同意して、[今すぐ購入] をクリックします。利用可能なエディションとその特徴の比較については、「インスタンスのエディション」をご参照ください。
注文ページで支払いを完了します。
お支払い後、[コンソール] をクリックして ApsaraMQ for MQTT コンソールに戻ります。
ステップ 2: インスタンスエンドポイントの取得
エンドポイントは、SDK クライアントがインスタンスに到達するために使用する接続 URL です。コードでメッセージングを構成する際に、この値が必要になります。
「ApsaraMQ for MQTT コンソール」で、[インスタンス] に移動し、インスタンスがデプロイされているリージョンを選択します。
インスタンス名をクリックするか、[操作] 列の [詳細] をクリックして [インスタンス詳細] ページを開きます。
[エンドポイント] タブをクリックします。「パブリックエンドポイント」を検索してコピーします。

ステップ 3: トピックの作成
トピックは、パブリッシャーとサブスクライバーがメッセージを交換するために使用するメッセージチャネルです。MQTT プロトコルは、スラッシュ (/) で区切られた階層に整理されたマルチレベルトピックをサポートしています。
親トピックはコンソールで作成する必要があります。
サブトピックはコードで直接指定され、コンソールで作成する必要はありません。
トピック命名形式: <parent-topic>/<level-2-topic>/<level-3-topic>
例: SendMessage/demo/producer
親トピックとすべてのサブトピックレベルの合計長は、64 文字を超えることはできません。トピックの構造の詳細については、「用語」をご参照ください。
親トピックを作成するには:
「[インスタンスの詳細]」ページで、左側のナビゲーションウィンドウの「[トピック]」をクリックします。
「[トピック]」ページの左上隅で、[トピックの作成] をクリックします。
[トピックの作成] パネルで、[名前] (例:
SendMessage) と [説明] を入力し、[OK] をクリックします。
ステップ 4: グループの作成
グループは、MQTT クライアントを管理するために使用されます。詳細については、「用語」をご参照ください。
「インスタンスの詳細」ページで、左側のナビゲーションウィンドウの[グループ]をクリックします。
[グループ] ページの左上隅で、[グループの作成] をクリックします。
「[グループの作成]」パネルで、[グループ ID](例:
GID_demo)を入力し、「[OK]」をクリックします。
セットアップの確認
リソースを作成したら、以下の項目が SDK 統合の準備ができていることを確認します。
| リソース | 場所 | SDK コードでの使用方法 |
|---|---|---|
| インスタンスのエンドポイント | インスタンスの詳細 > エンドポイント タブ | 接続 URL |
| 親トピック | インスタンスの詳細 > トピック | publish/subscribe 呼び出しにおける Topic パラメーター |
| グループ ID | インスタンスの詳細 > グループ | クライアント構成における Group ID パラメーター |
次のステップ
インスタンス、トピック、グループが準備できたら、メッセージングワークフローの構築を開始します。