0-普通设备（无子设备也无父设备） 1-网关设备(可挂载子设备) 2-子设备(归属于某个网关设备) 最小值：0 最大值：10 app_id String 应用ID 最小长度：0 最大长度：36 表6 ProductReferer 参数 参数类型 描述 product_id Integer

查看更多 →

名称 类型 描述 数组元素 Array<device> 设备信息。 表5 device 名称 类型 描述 client_id string 客户端ID。 device_id integer 设备ID。 device_name string 设备名称，支持英文大小写，数字，下划线和中划线，不超过64个字符。

查看更多 →

String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 device_name String 设备名称。 node_type

查看更多 →

最小长度：0 最大长度：64 请求示例 在指定父分组下创建一个设备分组 { "parent_id" : 10001, "name" : "device_group", "description" : "device group", "app_id" : "ef3845

查看更多 →

创建设备隧道 功能介绍 用户可以通过该接口创建隧道（WebSocket协议），应用服务器和设备可以通过该隧道进行数据传输。 该API接口在基础版不支持。 该API调用后平台会向对应的MQTT/MQTTS设备下发隧道地址及密钥，同时给应用服务器也返回隧道地址及密钥，设备可以通过该地

查看更多 →

创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则，用于子设备自主选择网关设备上线和上报消息，即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理

查看更多 →

设备Profile文件中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。物联网平台有两种命令下发机制：立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。缓存下发：平台收到命令后缓存起来，在设备可达时排队串行下发，平台收到前一个命令的响应（模组自动回复的

查看更多 →

设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。物联网平台有两种命令下发机制：立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。缓存下发：平台收到命令后缓存起来，在设备可达时排队串行下发，平台收到前一个命令的响应（模组自动回复的

查看更多 →

设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。物联网平台有两种命令下发机制：立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。缓存下发：平台收到命令后缓存起来，在设备可达时排队串行下发，平台收到前一个命令的响应（模组自动回复的

查看更多 →

分组描述 填写设备分组的描述信息。 添加设备到分组 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“设备集成 LINK > 设备管理”，在“设备分组”页签中选择要添加设备的设备分组。 单击“添加设备至分组”。 在

查看更多 →

应用服务器可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。一个设备只能归属一个设备组。StatusCode: 200 ok群组与标签

查看更多 →

应用服务器若需要向多个设备下发相同的设备命令时，可调用此接口向批量设备下发命令。此功能通过创建批量任务接口向设备下发批量任务实现，taskType参数设置为DeviceCmd时，为向批量设备下发命令。

查看更多 →

根据需要调整设备集信息可以快速创建设备集。 设置“成员信息”，可以通过“按拓扑结构选择”和“按设备类型选择”两种方式选择设备集的成员。 单击“确定”。 相关任务 用户可根据需要进行如下操作： 修改设备集：单击待修改的设备集名称，修改设备集成员。 当修改的设备集与用户相关联时，用户下次登录时权限变更生效。

查看更多 →

第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。CreateDeviceGroupInDTOCreateD

查看更多 →

第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。CreateDeviceGroupInDTOCreateD

查看更多 →

第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。支持第三方应用创建设备命令撤销任务，该任务用于撤销物联网平台中指定设备ID下所有未下发的命令（命令处于DEFAULT状态）。Cre

查看更多 →

典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务，该任务用于撤

查看更多 →

应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（PENDING状态），此时应用服务器可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。Status Code: 201 CreatedDeviceCommandResp：CommandDTO：命令下发

查看更多 →

参数 类型 是否必填 说明 product_name string 是 系统中已经创建好的产品的产品名。 device_name string 是 系统中已经创建好的设备的设备名。 topics Array of topics objects 是 自定义topic列表 表3 topics

查看更多 →

示例一：使用模板文件批量创建设备 场景描述 本章节指导用户通过API批量创建设备。API的调用方法参见如何调用API。 物联网平台支持通过请求参数和模板文件两种方式批量创建设备。本节以模板文件的方式为例，介绍如何批量创建设备。 涉及接口 查询产品列表：确定待创建设备所属的产品。 上传

查看更多 →

示例三：在指定资源空间下创建设备 场景描述 本章节指导用户通过API在指定资源空间下创建设备。API的调用方法参见如何调用API。 物联网平台默认为用户创建了一个资源空间，创建设备时默认将设备归属于默认资源空间，如果用户需要对设备分资源空间管理，可以指定资源空间创建设备。 涉及接口 创建资源空间：创建非系统默认的资源空间。

查看更多 →