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

禁用子设备

下行

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