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

IoT Platform:データソースを作成する

最終更新日:Mar 27, 2025

IoT Platform のルールエンジンのデータ転送機能を使用して、指定された Topic から他の Topic または他の Alibaba Cloud サービスにデータを転送できます。このトピックでは、データソースに Topic を追加する方法について説明します。

背景情報

データ転送パーサーを構成する場合は、パーサーをデータの転送元の Topic に関連付ける必要があります。 1 つのデータソースに最大 1,000 個の Topic を追加できます。

パーサースクリプトで topic(n) 関数を指定して、データの転送元の Topic を取得できます。詳細については、「関数」をご参照ください。

データソースを作成する

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

  3. 左側のナビゲーションウィンドウで、[メッセージ転送] > [データ転送] を選択します。
  4. [データ転送] ページの右上隅にある [新しいバージョンに移動] をクリックして、新しいバージョンに移動します。

    説明

    [メッセージ転送] > [データ転送] を選択すると、新しいバージョンの [データ転送] ページが表示されます。

  5. [データソース] タブをクリックします。 [データソース] タブで、[データソースの作成] をクリックします。

  6. データソースの名前と説明を入力します。次に、[OK] をクリックします。

    名前は 1 ~ 30 文字で、文字、数字、アンダースコア(_)、およびハイフン(-)を含めることができます。

    [データソースの詳細] ページが表示されます。右上隅にある [編集] をクリックして、データソースの名前と説明を変更できます。数据源详情

  7. [データソースの詳細] ページで、[topic の追加] をクリックします。表示されるダイアログボックスで、メッセージを処理する Topic を選択し、[OK] をクリックします。

    次の表に、サポートされている Topic について説明します。

    重要

    クラウドゲートウェイ プロダクトとデバイスを使用する場合、[カスタム] Topic、[デバイスステータス変更通知] Topic、および [ライフサイクル全体のデバイス変更] Topic のみを選択できます。メッセージ転送の Topic とデータ形式の詳細については、「オープンソース MQTT を介したメッセージング」、「JT/T 808 を介したメッセージング」、および「GB/T 32960 を介したメッセージング」をご参照ください。

    表 1. Topic

    Topic

    説明

    参照

    カスタム

    カスタム形式でデータを転送するために使用される Topic。この Topic の形式は、カスタム Topic の形式と同じです。形式:/${productKey}/${deviceName}/user/${TopicShortName}

    ${TopicShortName} は、カスタム Topic カテゴリ(カスタム Topic のサフィックス)を指定します。

    値には、プラス記号(+)や番号記号(#)などのワイルドカードを含めることができます。

    • すべての機器(+):指定されたプロダクトのすべてのデバイスを示します。

    • /user/#:指定されたデバイスのすべての Topic を示します。

    通信にカスタム Topic を使用する

    デバイスステータス変更通知

    デバイスのステータスがオンラインとオフラインの間で変化したときに通知を転送するために使用される Topic。形式:/${productKey}/${deviceName}/as/mqtt/status

    デバイスステータスを送信する

    TSL データレポート

    次の Topic が提供されています。

    • /${productKey}/${deviceName}/thing/event/property/post:この Topic は、デバイスのプロパティを転送するために使用されます。

    • /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post:この Topic は、デバイスのイベントを転送するために使用されます。

    • /${productKey}/${deviceName}/thing/property/batch/post:この Topic は、デバイスのプロパティをバッチで転送するために使用されます。

    • /${productKey}/${deviceName}/thing/event/batch/post:この Topic は、デバイスのイベントをバッチで転送するために使用されます。

    • /${productKey}/${deviceName}/thing/downlink/reply/message:この Topic は、デバイスが IoT Platform コマンドへの応答として返すメッセージを転送するために使用されます。

    次の Topic は、未加工のデバイスデータを送信するために使用されます。

    • /sys/${productKey}/${deviceName}/thing/event/property/post:この Topic は、デバイスプロパティを送信するために使用されます。

    • /sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post および /sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:{tsl.event.identifier}/post:これらの Topic は、デバイスイベントを送信するために使用されます。

    • /sys/${productKey}/${deviceName}/thing/event/property/batch/post:この Topic は、デバイスプロパティとイベントをバッチで送信するために使用されます。

    ライフサイクル全体のデバイス変更

    デバイスが作成、削除、無効化、または有効化されたときにメッセージを転送するために使用される Topic。形式:/${productKey}/${deviceName}/thing/lifecycle

    ライフサイクルの変更を送信する

    ゲートウェイによって検出されたサブデバイスデータレポート

    ゲートウェイがサブデバイスを検出したときに、新しいサブデバイスに関する情報を送信および転送するために使用される Topic。この Topic はゲートウェイに固有です。形式:/${productKey}/${deviceName}/thing/list/found

    検出されたサブデバイスに関する情報を送信する

    デバイスのトポロジ関係の変更

    サブデバイスとゲートウェイ間のトポロジ関係が作成または削除されたときに通知を転送するために使用される Topic。この Topic はゲートウェイに固有です。形式:/${productKey}/${deviceName}/thing/topo/lifecycle

    デバイスのトポロジ関係の変更

    /sys/${productKey}/${deviceName}/thing/topo/change:この Topic は、デバイスデータを送信するために使用されます。

    トポロジ関係の変更をゲートウェイに通知する

    デバイスタグの変更

    デバイスタグが変更されたときにメッセージを転送するために使用される Topic。形式:/${productKey}/${deviceName}/thing/deviceinfo/update

    デバイスタグの変更を送信する

    /sys/${productKey}/${deviceName}/thing/deviceinfo/update:この Topic は、デバイスデータを送信するために使用されます。

    タグを送信する

    TSL 履歴データレポート

    次の Topic が提供されています。

    • /${productKey}/${deviceName}/thing/event/property/history/post:この Topic は、履歴プロパティを転送するために使用されます。

    • /${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/history/post:この Topic は、履歴イベントを転送するために使用されます。

    /sys/${productKey}/${deviceName}/thing/event/property/history/post:この Topic は、履歴 TSL データを送信するために使用されます。

    デバイスプロパティ、イベント、およびサービス

    デバイスステータス通知

    次の Topic が提供されています。

    • /${productKey}/${deviceName}/ota/upgrade:この Topic は、無線(OTA)アップデート結果を転送するために使用されます。

    • /${productKey}/${deviceName}/ota/progress/post:この Topic は、アップデートの進捗状況を転送するために使用されます。

    上記の Topic は、次の Topic に対応しています。/ota/device/progress/${productKey}/${deviceName}。この Topic は、アップデートの進捗状況を送信するために使用されます。

    アップデートの進捗状況を IoT Platform に送信する

    モジュールバージョン番号を送信する

    デバイスの OTA モジュールのバージョン番号が変更されたときにメッセージを転送するために使用される Topic。形式:/${productKey}/${deviceName}/ota/version/post

    OTA モジュールバージョンを送信する

    上記の Topic は、次の Topic に対応しています。/ota/device/inform/${productKey}/${deviceName}。この Topic は、OTA モジュールのバージョン番号を送信するために使用されます。

    OTA モジュールバージョンを IoT Platform に送信する

    バッチステータス通知

    OTA アップデートバッチのステータスが変更されたときに IoT Platform がメッセージを送信する Topic。形式:/${productKey}/${packageId}/${jobId}/ota/job/status

    OTA アップデートバッチのステータスデータを送信する

    ジョブイベント

    /sys/uid/${uid}/distribution/${jobId}/lifecycle:デバイスジョブのステータスが変更されたときに通知を転送するために使用される Topic。

    説明

    インスタンス移行タスクの名前は、データを移行するプロダクトの名前と同じです。

    インスタンスのデータ移行タスクのステータスデータを送信する

  8. オプション前の手順を繰り返して、データソースに複数の Topic を追加します。

    ビジネス要件に基づいて、[データソースの詳細] ページで Topic を削除できます。Topic列表

  9. オプション手順 5 から 手順 8 までを繰り返して、複数のデータソースを作成します。

次の手順

データ転送先を作成する