:トポロジ関係の管理

サブデバイスのトポロジ関係を追加する

トピックを使用して、ゲートウェイとサブデバイス間のトポロジ関係を追加するリクエストを送信できます。 トポロジ関係が追加された場合、サブデバイスに関する情報が返されます。

次のトピックは、サブデバイスがIoT Platformにリクエストを送信し、IoT Platformがサブデバイスに応答を送信する場合に使用されます。

• リクエストトピック: /sys/${productKey}/${deviceName}/thing/topo/add
• レスポンストピック: /sys/${productKey}/${deviceName}/thing/topo/add_reply

Alink JSON形式のサンプルリクエスト:

{
  "id": "123",
  "version"： "1.0"、
  "sys":{
      "ack":0
  },
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554",
      "sign": "xxxxxx",
      "signmethod": "hmacSha1",
      "timestamp": "1524448722000",
      "clientId": "xxxxxx"
    }
  ],
  "method": "thing.topo.add"
} 

Alink JSON形式のサンプル応答:

{
  "id": "123",
  "code": 200,
  "data": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ]
}

リクエストパラメーター

sign= hmac_md5(deviceSecret, clientId123deviceNametestproductKey123timestamp1524448722000)

レスポンスパラメーター

エラーメッセージ

サブデバイスのトポロジ関係を削除する

トピックを使用して、ゲートウェイとサブデバイス間のトポロジ関係を削除する要求を送信できます。 トポロジ関係が削除された場合、サブデバイスに関する情報が返されます。

次のトピックは、サブデバイスがIoT Platformにリクエストを送信し、IoT Platformがサブデバイスに応答を送信する場合に使用されます。

• リクエストトピック: /sys/${productKey}/${deviceName}/thing/topo/delete
• レスポンストピック: /sys/${productKey}/${deviceName}/thing/topo/delete_reply

Alink JSON形式のサンプルリクエスト:

{
  "id": "123",
  "version"： "1.0"、
  "sys":{
      "ack":0
  },
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ],
  "method": "thing.topo.de lete"
} 

Alink JSON形式のサンプル応答:

{
  "id": "123",
  "code": 200,
  "data": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ]
}

リクエストパラメーター

レスポンスパラメーター

エラーメッセージ

サブデバイスのトポロジ関係のクエリ

次のトピックは、サブデバイスがIoT Platformにリクエストを送信し、IoT Platformがサブデバイスに応答を送信する場合に使用されます。

• リクエストトピック: /sys/${productKey}/${deviceName}/thing/topo/get
• レスポンストピック: /sys/${productKey}/${deviceName}/thing/topo/get_reply

トピックを使用して、ゲートウェイとサブデバイス間のトポロジ関係を照会するリクエストを送信できます。

Alink JSON形式のサンプルリクエスト:

{
  "id": "123",
  "version"： "1.0"、
  "sys":{
      "ack":0
  },
  "params": {},
  "method": "thing.topo.get"
} 

Alink JSON形式のサンプル応答:

{
  "id": "123",
  "code": 200,
  "data": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ]
}

リクエストパラメーター

レスポンスパラメーター

エラーメッセージ

新しく発見されたサブデバイスの送信

次のトピックは、サブデバイスがIoT Platformにリクエストを送信し、IoT Platformがサブデバイスに応答を送信する場合に使用されます。

• リクエストトピック: /sys/${productKey}/${deviceName}/thing/list/found
• レスポンストピック: /sys/${productKey}/${deviceName}/thing/list/found_reply

特定のシナリオでは、ゲートウェイは新しいサブデバイスを検出できます。 ゲートウェイは、新しいサブデバイスに関する情報をIoT Platformに報告します。 IoT Platformは情報をサードパーティアプリケーションに転送し、サードパーティアプリケーションはゲートウェイに接続するサブデバイスを選択します。

Alink JSON形式のサンプルリクエスト:

{
  "id": "123",
  "version"： "1.0"、
  "sys":{
      "ack":0
  },
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ],
  "method": "thing.list.found"
} 

Alink JSON形式のサンプル応答:

{
  "id": "123",
  "code": 200,
  "data" :{}
} 

リクエストパラメーター

レスポンスパラメーター

エラーメッセージ

ゲートウェイに通知してサブデバイスのトポロジ関係を追加する

次のトピックは、IoT Platformがサブデバイスにリクエストを送信し、サブデバイスがIoT Platformに応答を送信する場合に使用されます。

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

IoT Platformは、トピックを使用してゲートウェイに通知し、サブデバイスのトポロジ関係を追加できます。 これは、ゲートウェイが新しいサブデバイスを発見し、サブデバイス情報をIoT Platformに報告した後に適用されます。 IoT Platformは、次のデータ転送トピックをサブスクライブして、ゲートウェイから応答を受信できます。/${productKey}/${deviceName}/thing/downlink/reply/message。

Alink JSON形式のサンプルリクエスト:

{
  "id": "123",
  "version"： "1.0"、
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "1234556554"
    }
  ],
  "method": "thing.topo.add.notify"
} 

Alink JSON形式のサンプル応答:

{
  "id": "123",
  "code": 200,
  "data": {}
} 

リクエストパラメーター

レスポンスパラメーター

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

IoT Platformは、トポロジ関係の変更をゲートウェイに通知します。

ゲートウェイは、次のトピックをサブスクライブする必要があります。/sys/${productKey}/${deviceName}/thing/topo/change

Alink JSON形式のサンプルリクエスト:

{
    "id":"123",
    "version"： "1.0"、
    "param": {
        "status":0, // 0-追加1-削除2-再開無効8-無効
        "subList":[{
            "productKey":"a1hRrzD ****" 、
            "deviceName":"abcd"
        }]
    }, 
  "method":"thing.topo.change"
} 

リクエストパラメーター

Alink JSON形式のサンプル応答:

{
    "id":"123",
    "code":200,
    "message":"success",
    "data" :{}
}