名称 类型 描述 数组元素 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-普通设备（无子设备也无父设备） 1-网关设备(可挂载子设备) 2-子设备(归属于某个网关设备) 最小值：0 最大值：10 app_id String 应用ID。 最小长度：0 最大长度：36 表6 ProductReferer 参数 参数类型 描述 product_id Integer

查看更多 →

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

查看更多 →

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

查看更多 →

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

查看更多 →

选择是否开启安全连接。默认值为“是”，可选“否”。 是：表示会校验服务端证书。此选择能保证您与网站之间建立的连接安全性，请确保服务端证书的有效性，否则可能连接测试失败。 否：表示不校验服务端证书。此选择无法保证您与网站之间建立的连接安全性，请勿上传输敏感信息，可能会被攻击者盗取信息。 填写完成后

查看更多 →

创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台有两种命令下发机制： 立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。 缓存下发：

查看更多 →

创建设备策略 功能介绍 应用服务器可调用此接口在物联网平台创建一个策略，该策略需要绑定到设备和产品下才能生效。 一个实例最多能创建50个设备策略。 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 调用方法 请参见如何调用API。 URI POST /v5/iot/{pro

查看更多 →

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

查看更多 →

创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台有两种命令下发机制： 立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。 缓存下发：

查看更多 →

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

查看更多 →

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

查看更多 →

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

查看更多 →

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

查看更多 →

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

查看更多 →

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

查看更多 →

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

查看更多 →

默认值：5671。 device_coap_port 否 Integer 参数说明：设备接入COAP协议端口, 默认值：5683。 device_coaps_port 否 Integer 参数说明：设备接入COAPS协议端口, 默认值：5684。 device_mqtt_port

查看更多 →

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

查看更多 →

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

查看更多 →