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

查看更多 →

置，指定后将会根据service_id和desired设置的属性值与产品中对应属性的默认值比对，如果不同，则将以shadow字段中设置的属性值为准写入到设备影子中。service_id的值和desired内的属性必须是profile中定义的。 表4 AuthInfo 参数 是否必选

查看更多 →

String 厂商ID，未填写产品ID时厂商ID和型号必填。 最小长度：0 最大长度：64 model 否 String 型号，未填写产品ID时厂商ID和型号必填。 最小长度：0 最大长度：64 protocol_type 否 Integer 产品的协议类型：0-mqtt，1-CoAP，2

查看更多 →

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

查看更多 →

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

查看更多 →

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

查看更多 →

”对应字段后的填写框中。 从“Swagger出参”处拖动字段至“规范API出参”对应字段后的填写框中。 选择是否开启安全连接。默认值为“是”，可选“否”。 是：表示会校验服务端证书。此选择能保证您与网站之间建立的连接安全性，请确保服务端证书的有效性，否则可能连接测试失败。 否：表

查看更多 →

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

查看更多 →

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

查看更多 →

填写设备分组的名称，根据规划自定义。建议您按照一定的命名规则填写分组名称，方便您快速识别和查找。 分组描述 填写设备分组的描述信息。 集成应用 选择设备分组所属的集成应用。 添加子分组 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。 在左侧的导航栏选择“设备集成 LINK

查看更多 →

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

查看更多 →

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

查看更多 →

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

查看更多 →

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

查看更多 →

设备组名称，仅限大小写字母和数字。 description 可选 String(1024) body 设备组的描述信息。 appId 可选 String（50） body 如果是本应用的设备，此参数值可以填写None，否则填写授权应用的appId。 maxDevNum 可选 Integer（>=0） body

查看更多 →

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

查看更多 →

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

查看更多 →

参数说明：标签键，标签的键可用字母(包含中文)、数字、空格和以下字符：下划线(_)点(.)冒号(:)等号(=)加号(+)中划线(-)以及@，首尾不能有空格字符。 value 否 String 参数说明：标签值，可为空字符串和null，标签的值可用字母(包含中文)、数字、空格和以下字符：下划线(_)点(

查看更多 →

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

查看更多 →

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

查看更多 →