子设备
更新时间: 2023-04-19

# 获取可绑定子设备列表

# 基本信息

Path: /v1/devices/:instanceId/:productKey/subsets

Method: GET

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey

Query

参数名称 是否必须 示例 备注
pageNo
pageSize
name 搜索名称(未绑定网关设备的子设备name以及alias)
subProductKey subProductKey 子产品key
deviceName deviceName 网关设备名称

# 返回数据

名称类型是否必须默认值备注其他信息
totalCountnumber非必须
resultobject []非必须
├─ instanceIdstring必须
├─ deviceTypestring必须
├─ deviceSecretstring必须
├─ productNamestring必须
├─ updateTimestring必须
├─ last_online_timestring必须
├─ active_timestring必须
├─ authTypestring必须
├─ productKeystring必须
├─ createTimestring必须
├─ aliasstring必须
├─ active_stateboolean必须
├─ enable_statestring必须
├─ accessTypestring必须
├─ deviceNamestring必须
├─ online_statestring必须
├─ ban_statestring必须
pageNonumber非必须
pageSizenumber非必须

# 导入子设备拓扑

# 基本信息

Path: /v1/devices/:instanceId/:productKey/:deviceName/subsets/import

Method: POST

接口描述:

# 请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type multipart/form-data

路径参数

参数名称 示例 备注
instanceId
productKey
deviceName

Body

参数名称 参数类型 是否必须 示例 备注
importFile file

# 返回数据

# 导出子设备拓扑

# 基本信息

Path: /v1/devices/:instanceId/:productKey/:deviceName/subsets/export

Method: POST

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey
deviceName

Body

名称类型是否必须默认值备注其他信息
string []非必须
├─非必须deviceName

# 返回数据

名称类型是否必须默认值备注其他信息
rootobject非必须
├─ deviceNamestring非必须
├─ aliasstring非必须
├─ deviceTypestring非必须
├─ productKeystring非必须
leafobject []非必须
├─ deviceNamestring非必须
├─ aliasstring非必须
├─ deviceTypestring非必须
├─ productKeystring非必须

# 已绑定子设备列表

# 基本信息

Path: /v1/devices/:instanceId/:productKey/:deviceName/subsets

Method: GET

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey
deviceName

Query

参数名称 是否必须 示例 备注
pageNo
pageSize
name 搜索名称

# 返回数据

名称类型是否必须默认值备注其他信息
totalCountnumber非必须
resultobject []非必须
├─ instanceIdstring必须
├─ deviceTypestring必须
├─ deviceSecretstring必须
├─ productNamestring必须
├─ updateTimestring必须
├─ last_online_timestring必须
├─ active_timestring必须
├─ authTypestring必须
├─ productKeystring必须
├─ createTimestring必须
├─ aliasstring必须
├─ active_stateboolean必须
├─ enable_statestring必须
├─ accessTypestring必须
├─ deviceNamestring必须
├─ online_statestring必须
├─ ban_statestring必须
pageNonumber非必须
pageSizenumber非必须

# 批量绑定子设备

# 基本信息

Path: /v1/devices/:instanceId/:productKey/:deviceName/subsets

Method: POST

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey
deviceName

Body

名称类型是否必须默认值备注其他信息
object []非必须
├─ deviceNamestring必须
├─ productKeystring必须

# 返回数据

# 批量解绑子设备

# 基本信息

Path: /v1/devices/:instanceId/:productKey/:deviceName/subsets/delete

Method: POST

接口描述:

# 请求参数

路径参数

参数名称 示例 备注
instanceId
productKey
deviceName

Body

名称类型是否必须默认值备注其他信息
object []非必须
├─ deviceNamestring必须
├─ productKeystring必须

# 返回数据