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

IoT Platform:デバイスの分散

最終更新日:Apr 17, 2025

IoT Platform では、リージョン、インスタンス、またはアカウント間でデバイスを分散できます。IoT Platform コンソールでデバイスの分散を設定すると、IoT Platform はデバイスに通知を送信します。

デバイス分散通知

IoT Platform がダウンストリーム通知を送信し、デバイスがアップストリーム応答を送信するときは、次のトピックが使用されます。

  • リクエストトピック: /sys/${productKey}/${deviceName}/thing/bootstrap/notify
  • レスポンストピック: /sys/${productKey}/${deviceName}/thing/bootstrap/notify_reply

Alink リクエストフォーマット:

{
    "id": "123",
    "version": "1.0",
    "method": "thing.bootstrap.notify", 
    "params": {
      "cmd": 0 // コマンド。値 0 は、デバイスの分散が発生し、分散されたデバイスが新しい Bootstrap エンドポイントを取得するためのリクエストを送信することを示します。
    }
}

表 1. リクエストパラメーター

パラメータータイプ説明
idStringメッセージの ID。有効な値: 0 ~ 4294967295。各メッセージ ID は、現在のデバイスに対して一意である必要があります。
versionStringプロトコルのバージョン。このパラメーターを 1.0 に設定します。
methodStringリクエストメソッド。値を thing.bootstrap.notify に設定します。
paramsListリクエストパラメーターのリスト。
cmdInteger値を 0 に設定します。値 0 は、デバイスの分散が発生し、分散されたデバイスが新しい Bootstrap エンドポイントを取得するためのリクエストを送信することを示します。

Alink レスポンスフォーマット:

{
    "id": "456",
    "code":200, // HTTP ステータスコード。値 200 は、リクエストが成功したことを示します。その他の値は、リクエストが失敗したことを示します。
    "data" : {}
}

表 2. レスポンスパラメーター

パラメータータイプ説明
idStringメッセージの ID。有効な値: 0 ~ 4294967295。各メッセージ ID は、現在のデバイスに対して一意である必要があります。
codeIntegerレスポンスの HTTP ステータスコード。値 200 は、リクエストが成功したことを示します。その他の値は、リクエストが失敗したことを示します。詳細については、「デバイスから返される一般的なコード」をご参照ください。
dataObjectデバイスから返されたデータ。このレスポンスパラメーターは空です。