IoT Platform:AMQP サーバー側サブスクリプションを構成する

サブスクリプションを構成する

サブスクライブするメッセージのタイプを指定するには、次の手順を実行します。

1. IoT Platform コンソール にログインします。

2. [概要] ページで、[すべての環境] をクリックします。[すべての環境] タブで、管理するインスタンスを見つけ、インスタンス ID またはインスタンス名をクリックします。

3. 左側のナビゲーションウィンドウで、[メッセージ転送] > [サーバー側サブスクリプション] を選択します。

4. [サーバー側サブスクリプション] ページで、[サブスクリプションの作成] をクリックします。

5. [サブスクリプションの作成] ダイアログボックスで、パラメーターを構成し、[OK] をクリックします。次の表にパラメーターを示します。

   パラメーター	説明
   プロダクト	デバイスが属するプロダクトを選択します。デバイスによって送信されたメッセージは、コンシューマーにプッシュされます。
   サブスクリプションタイプ	[AMQP] を選択します。
   コンシューマーグループ	コンシューマーグループを選択します。1 つのプロダクトに複数のコンシューマーグループを指定し、1 つのコンシューマーグループに複数のプロダクトの複数のサブスクリプションを作成できます。 IoT Platform は、メッセージを消費するためのデフォルトのコンシューマーグループを提供します。コンシューマーをグループ化する場合、次の手順を実行してコンシューマーグループを作成します。[コンシューマーグループの選択] ダイアログボックスの右下隅にある [コンシューマーグループの作成] をクリックし、プロンプトに従ってパラメーターを構成します。詳細については、「コンシューマーグループを管理する」をご参照ください。
   メッセージタイプ	メッセージのタイプを選択します。次のタイプのデバイスメッセージをサブスクライブできます。基本的な通信 Topic、メッセージ転送 Topic、および関連するデータ形式の詳細については、「データ形式」をご参照ください。 重要 クラウドゲートウェイ製品とデバイスを使用している場合、IoT Platform は [デバイスアップストリーム通知]、[デバイスステータス変更通知]、および [ライフサイクル全体のデバイス変更] メッセージのみを製品とデバイスにプッシュします。メッセージ転送 Topic とデータ形式の詳細については、「オープンソース MQTT を介したメッセージング」、「JT/T 808 を介したメッセージング」、および「GB/T 32960 を介したメッセージング」をご参照ください。 [デバイスアップストリーム通知]: [許可される操作] パラメーターが [パブリッシュ] に設定されている Topic のメッセージ。詳細については、「Topic」をご参照ください。 メッセージには、デバイスによって送信されたカスタムデータと TSL（Thing Specification Language）データが含まれます。アップストリーム TSL データには、プロパティデータ、イベントデータ、プロパティ設定リクエストへの応答、およびサービス呼び出しへの応答が含まれます。ユーザーサーバーにプッシュされる TSL データは、IoT Platform によって処理されます。詳細については、「データ形式」をご参照ください。 たとえば、プロダクトに対して次の Topic カテゴリが定義されています。 /${YourProductKey}/${YourDeviceName}/user/get。この Topic カテゴリの [許可される操作] パラメーターは [サブスクライブ] に設定されています。 /${YourProductKey}/${YourDeviceName}/user/update。この Topic カテゴリの [許可される操作] パラメーターは [パブリッシュ] に設定されています。 /${YourProductKey}/${YourDeviceName}/thing/event/property/post。この Topic カテゴリの [許可される操作] パラメーターは [パブリッシュ] に設定されています。 サーバー側サブスクリプション機能は、次の Topic カテゴリのメッセージをプッシュします。/${YourProductKey}/${YourDeviceName}/user/update および /${YourProductKey}/${YourDeviceName}/thing/event/property/post。 重要 非同期サービス呼び出しの応答データをサブスクライブする場合は、デバイスから返されるメッセージ ID が、IoT Platform がダウンストリームデータを送信するときに生成されるメッセージ ID と同じであることを確認してください。 [デバイスステータス変更通知]: デバイスがオンラインまたはオフラインになったときにデバイスから送信される通知。 [ゲートウェイのサブデバイス検出レポート]: ゲートウェイが新しいサブデバイスを検出したときにゲートウェイが送信するサブデバイスデータ。ゲートウェイには、サブデバイスを検出するために使用できるアプリケーションが必要です。このメッセージタイプはゲートウェイに固有です。 [デバイストポロジー関係の変更]: サブデバイスとゲートウェイ間のトポロジー関係が作成または削除されたときにゲートウェイが送信する通知。このメッセージタイプはゲートウェイに固有です。 [ライフサイクル全体のデバイス変更]: デバイスが作成、削除、有効化、または無効化されたときにデバイスが送信する通知。 [TSL 履歴データレポート]: デバイスによって送信される履歴プロパティとイベント。 [OTA アップデートステータス通知]: ファームウェアの検証と一括更新中にデバイスから送信される通知。デバイスの更新タスクが成功、失敗、キャンセル、または実行中の場合、通知がプッシュされます。 [デバイスタグの変更]: デバイスタグが変更されたときにデバイスから送信されるメッセージ。 [モジュールバージョン番号を送信する]: OTA（無線）モジュールバージョンが変更されたときにデバイスから送信されるメッセージ。 [バッチステータス通知]: OTA 更新バッチのステータスが変更されたときにデバイスから送信される通知。 説明 デバイスメッセージをリッスンする場合、メッセージのフィルタリングまたは処理が必要になる場合があります。この場合、データ転送ルールを使用して、メッセージを AMQP コンシューマーグループに転送できます。その後、AMQP クライアントを使用してメッセージを受信できます。 詳細については、「データ転送」をご参照ください。 AMQP サーバーへのメッセージの転送方法とサブスクライブできるデバイス Topic の詳細については、「データ形式」をご参照ください。

プロダクトのサブスクリプションを管理する

サブスクリプションを構成した後、[サーバー側サブスクリプション] ページに移動し、サブスクリプションが作成されたプロダクトを見つけます。サブスクリプションに対して複数の操作を実行できます。次の表に操作を示します。