检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
gateway_id 否 String 参数说明：网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。 最大长度：256 tags 否 Array
通过设备发放实现批量设备自动注册 场景说明 当前物联网平台基于安全考虑，需要将设备的基本信息（例如设备ID、鉴权信息）注册到平台后，设备才能连接上平台。当用户的设备数不断增多时，如何安全且快速的注册设备尤为关键，需要采用安全的批量注册的场景。本文基于设备发放注册组功能，使用证书策
设备侧获取平台的设备影子数据 功能介绍 用于设备向平台获取设备影子数据。用户可以通过应用服务器或物联网控制台配置设备影子预期数据，设备上线时订阅该topic，可以获取到平台设备影子数据，以此来同步设备属性期望值，从而完成设备属性值的修改。 简单交互逻辑介绍如下： ① 应用调用“配
object_device_id 可选 String 参数解释： 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。
携带的设备证书指纹。 使用设备证书接入平台。 图1 设备连接参数 进入设备接入控制台，左侧导航栏选择“设备 > 设备证书”，选择“设备证书”查看设备证书列表与详情。 图2 设备证书-证书列表 图3 设备证书-证书详情 进入设备接入控制台，左侧导航栏选择“设备 > 所有设备”，选择
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个，建议分不同批次进行上报。
设备属性上报 功能介绍 用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。
设备时间同步响应 功能描述 平台向设备发送时间同步响应，携带设备发送时间device_send_time。当平台收到时间server_recv_time 后，向设备发送时间server_send_time 。 例如，设备收到的设备侧时间为device_recv_time ，则设备计算自己的准确时间为：
access_token 是 String Header 参数解释: 调用设备鉴权信息返回的access_token。 取值范围: 长度1-256。 device_id 是 String Path 参数解释: 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分
在左侧导航栏选择“设备”，单击“所有设备”，单击设备的“详情”进入设备详情。 选择“标签”页签，单击“绑定标签”给设备添加标签。 图14 设备-绑定标签 群组相关API接口 查询设备组列表 添加设备组 查询设备组 修改设备组 删除设备组 管理设备组中的设备 查询设备组设备列表 标签相关API接口
网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。 若为空则默认该参数与Topic中的device_id一致。 services
所属行业 请根据实际情况填写。 设备类型 请根据实际情况填写。 图1 创建产品-MQTT 注册设备。在左侧导航栏选择“ 设备 > 所有设备”，单击“注册设备”，按照如下表格填写参数后，单击“确定”，设备注册成功后，请妥善保管好设备ID和密钥，用于设备接入平台认证。 参数名称 配置说明
网关上报子设备属性时一次最大可上报子设备数量为100个。 使用说明 图2 设备属性上报操作流程 创建产品与设备、设定物模型：创建产品流程、创建设备流程、设定产品模型。 设备鉴权：平台验证设备是否具有接入权限。 设备属性上报：设备通过MQTT/HTTP/LwM2M等协议上报属性数据。 按
addDevice: 添加设备。添加已注册的设备到指定的设备组中。 removeDevice: 删除设备。从指定的设备组中删除设备，只是解除了设备和设备组的关系，该设备在平台仍然存在。 device_id 是 String 参数说明：设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。
509证书认证，并关联已认证的设备CA证书； 3. 开发设备端，将X.509证书及其私钥烧录到设备上； 4. 设备在与平台双向认证过程中，设备验证平台证书，平台使用设备CA证书验证设备证书并验证设备证书与设备的关联关系。 X.509双向证书认证 X.509证书双向认证过程，涉及到设备发放（平台）和设备两端，过程如下图所示。
网关更新子设备状态 功能介绍 网关更新子设备状态，更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系，请查看网关与子设备。 接口tps限制为直连设备并发建链的1.5倍。即为单个实例每秒最大建立请求连接数量为100*购买单元数量 *1.5。 该接口1次调用的tps为1*上报子设备的数量。
MQTT设备OTA升级 MQTT协议设备软件升级流程 MQTT协议SOTA升级流程的详细说明： 1～2. 用户在设备管理服务的控制台上传软件包，并在控制台或者应用服务器上创建软件升级任务。 3. 平台感知设备是否在线，当设备在线时立即触发升级协商流程。当设备不在线时，等待设备上线订
测试验证步骤如下： 在设备接入控制台，进入“设备 > 所有设备”，单击具体设备，启动“消息跟踪”。 图3 消息跟踪-启动消息跟踪 设备端运行设备侧SDK代码，设备侧消息上报日志格式样例如下： 图4 java SDK消息上报结果log “消息跟踪”显示结果如下，平台已经收到设备的消息上报，并且已经触发流转规则:
请求数)。 单实例最大支持创建10个设备代理。 一个设备代理中最多能添加10个设备。 仅支持直连/网关设备加入设备代理，子设备不允许添加至设备代理中。 一个设备仅允许加入一个设备代理中。 样例演示 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
参数解释： 待删除的子设备（设备id）列表，单次删除最大不超过50个设备。 示例 Topic: $oc/devices/{device_id}/sys/events/up 数据格式： { "object_device_id": "{object_device_id}", "services":
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
