在鸿云文档

Appearance

平台通知网关(直连设备)拓扑关系变化 ​

设备管理平台控制台操作添加或移除子设备时，将拓扑关系变化通知网关(直连设备)。

操作
行为方式
网关(直连设备)下添加子设备添加网关(直连设备)与子设备的拓扑关系。平台添加网关(直连设备)与子设备的拓扑关系
移除子设备移除子设备与对应网关(直连设备)的拓扑关系。平台移除子设备

平台添加子设备通知拓扑关系变化topic定义 ​

添加子设备时请求topic：tlink/${productKey}/${deviceName}/topo/changeAdd

数据流向：平台发布消息，网关(直连设备)监听消息

平台添加子设备通知拓扑关系变化请求数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
  "v": "1",
  "t": 1630054074378,
   "method": "tlink.${productKey}.${deviceName}.topo.changeAdd",
  "data": [
    {
      "deviceName": "sn1234或mac1234",
      "productKey": "a1234******"
      "subList": []
    },
    {
      "deviceName": "sn456或mac456",
      "productKey": "a4567******"
      "subList": [
           {
             "deviceName": "sn789或mac789",
             "productKey": "a789******"
 			     },
            {
             "deviceName": "sn001或mac001",
             "productKey": "a001******"
 			      }
      ]
    }
  ]
}

请求参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。全局唯一，用于系统消息追踪
vString是协议版本号，目前协议版本号唯一取值为1
tLong是消息发送时间戳
methodString否TCP连接时必传
dataList是请求数据列表。
  productKeyString是一级子设备的产品productKey。
  deviceNameString是一级子设备的唯一标识。
  subListList否二级子设备列表，当二级子设备列表为空时，表示添加的是一级子设备拓扑关系，当二级子设备不为空时，表示添加的是二级子设备拓扑关系。
    productKeyString是二级子设备的产品productKey。
    deviceNameString是二级子设备的唯一标识。

平台添加子设备通知拓扑关系变化响应topic定义 ​

响应topic：tlink/${productKey}/${deviceName}/topo/changeAdd_reply

数据流向：网关(直连设备)发布消息，平台监听消息

平台添加子设备通知拓扑关系变化响应数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
   "method": "tlink.${productKey}.${deviceName}.topo.changeAdd_reply",
  "code": 200,
  "data": {}
}

响应参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。和请求的对应
methodString否TCP连接时必传
codeInteger是结果状态码。成功为200，其他为失败
dataObject否请求成功时，返回的数据。不需要返回则为空。

平台移除子设备通知拓扑关系变化topic定义 ​

topic：tlink/${productKey}/${deviceName}/topo/changeDelete

数据流向：平台发布消息，网关(直连设备)监听消息

平台移除子设备通知拓扑关系变化请求数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
  "v": "1",
  "t": 1630054074378,
   "method": "tlink.${productKey}.${deviceName}.topo.changeDelete",
  "data": [
    {
      "deviceName": "sn1234或mac1234",
      "productKey": "a1234******"
      "subList": []
    },
    {
      "deviceName": "sn456或mac456",
      "productKey": "a4567******"
      "subList": [
           {
             "deviceName": "sn789或mac789",
             "productKey": "a789******"
 					 }
      ]
    }
  ]
}

请求参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。全局唯一，用于系统消息追踪
vString是协议版本号，目前协议版本号唯一取值为1
tLong是消息发送时间戳
methodString否TCP连接时必传
dataList是请求数据列表。
  productKeyString是一级子设备的产品productKey。
  deviceNameString是一级子设备的唯一标识。
  subListList否二级子设备列表，当二级子设备列表为空时，表示移除的是一级子设备拓扑关系。
当二级子设备不为空时，表示移除的是二级子设备拓扑关系。
    productKeyString是二级子设备的产品productKey。
    deviceNameString是二级子设备的唯一标识。

平台移除子设备通知拓扑关系变化响应topic定义 ​

响应topic：tlink/${productKey}/${deviceName}/topo/changeDelete_reply

数据流向：网关(直连设备)发布消息，平台监听消息

平台移除子设备通知拓扑关系变化响应数据体格式 ​

javascript
{
  "reqid": "0020fdf71f0d491da12ba3cd38b205be",
   "method": "tlink.${productKey}.${deviceName}.topo.changeDelete_reply",
  "code": 200,
  "data": {}
}

响应参数说明

参数名称
类型
是否必选
描述
reqidString是消息ID号。和请求的对应
methodString否TCP连接时必传
codeInteger是结果状态码。成功为200，其他为失败
dataObject否请求成功时，返回的数据。不需要返回则为空。