网关类型设备可以禁用、启用(解除禁用)和删除子设备。

禁用子设备

下行

  • 请求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