文档首页/ 设备接入 IoTDA/ API参考/ 设备侧MQTT/MQTTS接口参考/ 网关与子设备管理/ 网关删除子设备请求
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

网关删除子设备请求

功能介绍

网关主动删除其下接入的子设备，在平台上完成销户。网关与子设备关系，请查看网关与子设备。

Topic

上行: $oc/devices/{device_id}/sys/events/up

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

参数解释：

该参数目前暂未实装使用，无需填写。

services

可选

List<ServiceEvent>

参数解释：

事件服务列表。

ServiceEvent定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

参数解释：

系统字段。

取值范围：

固定为："$sub_device_manager"。

event_type

必选

String

参数解释：

系统字段。

取值范围：

固定为："delete_sub_device_request"。

event_time

可选

String

参数解释：

事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。

设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。

event_id

可选

String

参数解释：

事件请求Id，唯一标识这次事件请求。如果不携带该参数，该参数由物联网平台自动生成，生成规则为数字、字母、中划线组成的36位随机字符串。

paras

必选

Object

参数解释：

事件参数JSON对象。

paras参数列表

字段名

必选/可选

类型

参数描述

devices

必选

List<String>

参数解释：

待删除的子设备（设备id）列表，单次删除最大不超过50个设备。

示例

Topic: $oc/devices/{device_id}/sys/events/up 
数据格式： 
{
  "object_device_id": "{object_device_id}",
  "services": [
    {
      "service_id": "$sub_device_manager",
      "event_type": "delete_sub_device_request",
      "event_time": "20151212T121212Z",
      "event_id": "40cc9ab1-3579-488c-95c6-c18941c99eb4",
      "paras": {        
        "devices": [
          "c6b39067b0325db34663d3ef421a42f6_subdevice11",
          "c6b39067b0325db34663d3ef421a42f6_subdevice12"
        ]
      }
    }
  ]
}