参数类型 描述 project_id 是 String 项目ID，获取方式请参见API参考的“附录 > 获取项目ID”章节。 最小长度：0 最大长度：32 instance_id 是 String 实例的ID。 最小长度：0 最大长度：36 请求参数 表2 请求Header参数 参数 是否必选

查看更多 →

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

查看更多 →

租户每个区域对应的项目ID。 instance_id string 是 租户使用ROMA Connect的实例ID。 请求消息 请求参数 表2 Body参数 参数 类型 是否必填 说明 product_name string 是 系统中已经创建好的产品的产品名。 devices Array<device>

查看更多 →

获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时

查看更多 →

获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时

查看更多 →

id}/device-groups 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方式请参见API参考的“附录 > 获取项目ID”章节。 最小长度：0 最大长度：32 instance_id 是 String 实例的ID。 最小长度：0

查看更多 →

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

查看更多 →

缓存下发：平台收到命令后缓存起来，在设备可达时排队串行下发，平台收到前一个命令的响应（模组自动回复的ACK）才会下发后一个命令，保证串行性，不保证实时性。 此接口适用于使用LWM2M/CoAP协议接入的设备，例如NB-IoT设备。 接口功能 支持第三方应用向LWM2M/CoAP设备下发命令，实现对设备的控制。

查看更多 →

参数说明：资源空间ID。此参数为非必选参数，存在多资源空间的用户需要使用该接口时，建议携带该参数指定创建的设备归属到哪个资源空间下，否则创建的设备将会归属到默认资源空间下。 取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。 statement 是 Array of

查看更多 →

缓存下发：平台收到命令后缓存起来，在设备可达时排队串行下发，平台收到前一个命令的响应（模组自动回复的ACK）才会下发后一个命令，保证串行性，不保证实时性。 此接口适用于使用LWM2M/CoAP协议接入的设备，例如NB-IoT设备。 接口功能 支持第三方应用向LWM2M/CoAP设备下发命令，实现对设备的控制。

查看更多 →

LINK > 设备管理”，在“设备分组”页签中选择要添加子分组的设备分组。 添加的子分组要与需要添加到子分组中的设备在同一应用下。 单击设备分组名称右侧的。 在创建分组弹窗中配置设备分组相关信息，完成后单击“确认”。 表2 子分组信息配置 参数 配置说明 父组 子分组所属的父分组信息。

查看更多 →

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

查看更多 →

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

查看更多 →

当修改的设备集与用户相关联时，用户下次登录时权限变更生效。 删除设备集：单击目标设备集“操作”列的“删除”。 当删除的设备集与用户相关联时，删除设备集会使关联用户失去该设备集包含的所有对象的管理权限。 父主题： 用户授权

查看更多 →

处理建议：请检查已创建的设备组数量是否已达到License限定的数量上限。 400 100609 Too much devices to add. 添加太多设备至设备组。 处理建议：请确认deviceIds中的设备ID数量在maxDevNum设置值的范围内。 400 50400 The input

查看更多 →

处理建议：请检查已创建的设备组数量是否已达到License限定的数量上限。 400 100609 Too much devices to add. 添加太多设备至设备组。 处理建议：请确认deviceIds中的设备ID数量在maxDevNum设置值的范围内。 400 50400 The input

查看更多 →

taskId String(1-64) 设备命令撤销任务的任务ID。 appId String(1-64) 设备命令撤销任务所属的应用ID。 deviceId String(1-64) 执行设备命令撤销任务的设备ID。 status String 撤销任务的任务状态。 WAITTING表示等待执行中

查看更多 →

见下表CreateDeviceCmdCancelTaskInDTO的描述。 appId 可选 String query 如果是本应用的设备，此参数值可以填写None，否则填写授权应用的appId。 accessToken 必选 String header 填写鉴权接口获取的accessToken。 Creat

查看更多 →

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

查看更多 →

租户每个区域对应的项目ID。 instance_id string 是 租户使用ROMA Connect的实例ID。 请求消息 请求参数 表2 Body参数 参数 类型 是否必填 说明 product_name string 是 系统中已经创建好的产品的产品名。 device_name

查看更多 →

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

查看更多 →