全部產品
Search
文件中心

IoT Platform:子裝置禁用、啟用、刪除

更新時間:Jun 30, 2024

網關類型裝置可以禁用、啟用(解除禁用)和刪除子裝置。

禁用子裝置

下行

  • 請求Topic:/sys/${productKey}/${deviceName}/thing/disable
  • 響應Topic:/sys/${productKey}/${deviceName}/thing/disable_reply

適用於網關類型裝置,使用該功能通知網關禁用子裝置。物聯網平台的雲端使用非同步方式推送禁用裝置的訊息;子裝置通過網關訂閱該Topic擷取訊息。

Alink請求資料格式

{
  "id": "123",
  "version": "1.0",
  "params": {},
  "method": "thing.disable"
}

Alink響應資料格式

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

參數說明

參數取值說明
idString

訊息ID號。String類型的數字,取值範圍0~4294967295,且每個訊息ID在當前裝置中具有唯一性。

versionString協議版本號碼,目前協議版本號碼唯一取值為1.0
paramsObject請求參數, 為空白即可。
methodString要求方法,取值thing.disable
codeInteger結果資訊, 請參見裝置端通用code

啟用被禁用的子裝置

下行

重要
  • 網關子裝置通過MQTT協議接入物聯網平台後,需通過網關訂閱Topic擷取訊息。若子裝置被禁用會處於離線狀態,無法擷取已訂閱Topic的訊息。因此,被禁用的網關子裝置不能通過以下Topic啟用,需通過修改拓撲關係啟用,Topic說明,請參見通知網關拓撲關係變化
  • 裝置通過云云對接SDK接入物聯網平台後,無需裝置訂閱Topic,即可收到對應訊息。若子裝置被禁用離線,可通過以下Topic啟用上線。
  • 請求Topic:/sys/${productKey}/${deviceName}/thing/enable
  • 響應Topic:/sys/${productKey}/${deviceName}/thing/enable_reply

適用於網關類型裝置,使用該功能通知網關重新啟用被禁用的子裝置。物聯網平台的雲端使用非同步方式推送啟用子裝置的訊息;子裝置通過該Topic擷取訊息。

Alink請求資料格式

{
  "id": "123",
  "version": "1.0",
  "params": {},
  "method": "thing.enable"
}

Alink響應資料格式

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

參數說明

參數取值說明
idString

訊息ID號。String類型的數字,取值範圍0~4294967295,且每個訊息ID在當前裝置中具有唯一性。

versionString協議版本號碼,目前協議版本號碼唯一取值為1.0
paramsObject請求參數, 為空白即可。
methodString要求方法,取值thing.enable
codeInteger結果資訊,請參見裝置端通用code

刪除子裝置

重要 網關裝置會直接刪除已接入物聯網平台的子裝置。刪除裝置的影響說明,請參見刪除裝置

下行

  • 請求Topic:/sys/${productKey}/${deviceName}/thing/delete
  • 響應Topic:/sys/${productKey}/${deviceName}/thing/delete_reply

適用於網關類型裝置,使用該功能通知網關刪除子裝置。物聯網平台的雲端使用非同步方式推送刪除裝置的訊息;子裝置通過網關訂閱該Topic擷取訊息。

Alink請求資料格式

{
  "id": "123",
  "version": "1.0",
  "params": {},
  "method": "thing.delete"
}

Alink響應資料格式

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

參數說明

參數取值說明
idString

訊息ID號。String類型的數字,取值範圍0~4294967295,且每個訊息ID在當前裝置中具有唯一性。

versionString協議版本號碼,目前協議版本號碼唯一取值為1.0
paramsObject請求參數, 為空白即可。
methodString要求方法,取值thing.delete
codeString結果資訊,請參見裝置端通用code