ApsaraMQ for MQTT SDK を使用してメッセージを送受信する前に、ApsaraMQ for MQTT コンソールでインスタンス、トピック、グループなどの関連リソースを作成する必要があります。 ApsaraMQ for MQTT SDK を使用してメッセージを送受信する場合は、コードでこれらのリソースに関する情報を指定する必要があります。
始める前に
ApsaraMQ for MQTT をアクティブ化し、RAM ユーザーに ApsaraMQ for MQTT リソースへのアクセスを承認する
インスタンスを作成し、インスタンスのエンドポイントを取得する
ApsaraMQ for MQTT では、インスタンスはトピックとグループに関連する情報を格納するために使用される仮想マシンです。
ApsaraMQ for MQTT コンソール にログオンします。左側のナビゲーションペインで、インスタンスリスト をクリックします。
上部のナビゲーションバーで、管理するインスタンスが存在するリージョンを選択します。次に、左上隅にある インスタンスの作成 をクリックします。
表示されるパネルで、支払方法 パラメーターにデフォルト値 サブスクリプション を使用します。次に、OK をクリックします。
表示される購入ページで、ビジネス要件に基づいて購入するインスタンスの仕様を選択し、[サービス規約] を選択して、[今すぐ購入] をクリックします。
ApsaraMQ for MQTT が提供するインスタンスエディションとその機能の違いについては、インスタンスエディション をご参照ください。
注文支払いページで、画面の指示に従って支払いを完了します。
支払いが完了したら、表示されるページで [コンソール] をクリックします。
ApsaraMQ for MQTT コンソール に戻ります。左側のナビゲーションペインで、インスタンスリスト をクリックします。上部のナビゲーションバーで、インスタンスがデプロイされているリージョンを選択します。
インスタンスリスト ページで、インスタンスの名前をクリックするか、インスタンスの 詳細操作 列の インスタンスの詳細 をクリックして、 ページに移動します。
インスタンスの詳細 ページで、アクセスポイント タブをクリックします。タブで、エンドポイント情報を確認できます。この例では、[パブリックエンドポイント] が使用されています。
トピックを作成する
MQTT プロトコルは複数レベルのトピックをサポートしています。 ApsaraMQ for MQTT コンソールで親トピックを作成する必要があります。コンソールでサブトピックを作成する必要はなく、コードでサブトピックを指定できます。親トピックとそのサブトピックは、<親トピックの名前>/<レベル 2 トピックの名前>/<レベル 3 トピックの名前> の形式で名前が付けられます。親トピックとそのサブトピックはスラッシュ (/) で区切られます。例: SendMessage/demo/producer。親トピックとそのサブトピックの名前の合計の長さは 64 文字を超えることはできません。トピックの詳細については、用語 をご参照ください。
ApsaraMQ for MQTT コンソール にログオンします。左側のナビゲーションペインで、インスタンスリスト をクリックします。
上部のナビゲーションバーで、管理するインスタンスが存在するリージョンを選択します。[インスタンス] ページで、インスタンス名をクリックして インスタンスの詳細 ページに移動します。
- 左側のナビゲーションペインで、トピックの管理 をクリックします。[トピック] ページの左上隅にある トピックの作成 をクリックします。
- [トピックの作成] パネルで、トピックの 名前 パラメーターと 記述 パラメーターを設定し、左下隅にある [OK] をクリックします。
グループを作成する
グループ ID の詳細については、用語 をご参照ください。
ApsaraMQ for MQTT コンソール にログオンします。左側のナビゲーションペインで、インスタンスリスト をクリックします。
上部のナビゲーションバーで、管理するインスタンスが存在するリージョンを選択します。[インスタンス] ページで、インスタンス名をクリックして インスタンスの詳細 ページに移動します。
- 左側のナビゲーションペインで、グループ管理 をクリックします。[グループ] ページの左上隅にある グループの作成 をクリックします。
- [グループの作成] パネルで、Group ID パラメーターを設定し、[OK] をクリックします。