检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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、鉴权信息）注册到平台后，设备才能连接上平台。当用户的设备数不断增多时，如何安全且快速的注册设备尤为关键，需要采用安全的批量注册的场景。本文基于设备发放注册组功能，使用证书策
object_device_id 可选 String 参数解释： 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个，建议分不同批次进行上报。
设备属性上报 功能介绍 用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。
设备时间同步响应 功能描述 平台向设备发送时间同步响应，携带设备发送时间device_send_time。当平台收到时间server_recv_time 后，向设备发送时间server_send_time 。 例如，设备收到的设备侧时间为device_recv_time ，则设备计算自己的准确时间为：
请求数)。 单实例最大支持创建10个设备代理。 一个设备代理中最多能添加10个设备。 仅支持直连/网关设备加入设备代理，子设备不允许添加至设备代理中。 一个设备仅允许加入一个设备代理中。 样例演示 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
设备进行绑定。本文介绍如何在物联网平台上传设备CA证书，以及注册X.509证书认证的设备。 限制说明 当前只有通过MQTT接入的设备支持使用X.509证书进行设备身份认证。 每个用户最多上传100个设备CA证书。 上传设备CA证书 访问设备接入服务，单击“管理控制台”进入设备接入
所属行业 请根据实际情况填写。 设备类型 请根据实际情况填写。 图1 创建产品-MQTT 注册设备。在左侧导航栏选择“ 设备 > 所有设备”，单击“注册设备”，按照如下表格填写参数后，单击“确定”，设备注册成功后，请妥善保管好设备ID和密钥，用于设备接入平台认证。 参数名称 配置说明
限制最大为1/S(每秒1次请求数)。 使用场景 设备检索：在所有设备-设备列表界面通过类SQL语句方式，检索指定的设备进行后续管理操作。 设备动态分组：通过设备动态分组的类SQL语句规则，过滤出来符合条件的设备自动加入到群组进行管理。 操作步骤 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
网关上报子设备属性时一次最大可上报子设备数量为100个。 使用说明 图2 设备属性上报操作流程 创建产品与设备、设定物模型：创建产品流程、创建设备流程、设定产品模型。 设备鉴权：平台验证设备是否具有接入权限。 设备属性上报：设备通过MQTT/HTTP/LwM2M等协议上报属性数据。 按
addDevice: 添加设备。添加已注册的设备到指定的设备组中。 removeDevice: 删除设备。从指定的设备组中删除设备，只是解除了设备和设备组的关系，该设备在平台仍然存在。 device_id 是 String 参数说明：设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。
息完成接入鉴权。 设备名称 设备发放时，设备名称将作为主要的筛选条件之一，建议按照统一的规则规划不同地区的设备名称。 例如：北京地区设备，设备名称都携带Beijing；香港地区设备，设备名称都携带Hongkong。 设备ID 设备ID默认为产品ID+“_”+设备标识码，用户也可自己定义。
在设备接入控制台左侧导航栏，选择“设备 > 所有设备”，进入设备列表页，设备列表默认显示当前实例下的所有设备。 单击需要进行操作的设备“详情”按钮，单击“重置密钥/重置指纹”，单击“辅密钥/辅指纹”。 图1 设备详情-重置辅密钥 图2 设备详情-重置辅指纹 相关API接口 重置设备指纹 重置设备密钥 父主题：
网关更新子设备状态 功能介绍 网关更新子设备状态，更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系，请查看网关与子设备。 接口tps限制为直连设备并发建链的1.5倍。即为单个实例每秒最大建立请求连接数量为100*购买单元数量 *1.5。 该接口1次调用的tps为1*上报子设备的数量。
台注册设备，获取设备ID和密钥，并把设备ID和密钥烧录到设备中。对于使用MQTTS协议接入的设备，需要在设备侧预置CA证书；对于使用MQTT非安全协议接入的设备，无需在设备侧预置CA证书。在设备接入物联网平台时携带设备ID和密钥，完成设备的接入鉴权。 使用证书鉴权： 在设备接入物
平台感知设备是否在线，当设备在线时立即触发升级协商流程。当设备不在线时，等待设备上线订阅升级Topic，平台感知设备上线，触发升级协商流程。（等待设备上线时间25小时以内） 4~5. 平台向设备下发查询设备固件版本号的命令，查询成功后，物联网平台根据升级的目标版本判断设备是否需要升级
单个MQTT连接每秒最大上行消息数量为50条（一次请求为一条）。 使用说明 图2 设备消息上报操作流程 创建产品与设备：创建产品流程、创建设备流程。 设备鉴权：平台验证设备是否具有接入权限。 设备消息上报：设备通过MQTT/HTTPS等协议发送消息数据。 按照不同的设备协议，调用的接口不一样，下面分别介绍MQTT、HTTPS协议消息上报的样例：
参数解释： 待删除的子设备（设备id）列表，单次删除最大不超过50个设备。 示例 Topic: $oc/devices/{device_id}/sys/events/up 数据格式： { "object_device_id": "{object_device_id}", "services":
选择左侧导航栏的“设备 > 所有设备”，单击“注册设备”，填写设备注册参数。 图3 单设备注册-MQTT 表2 注册设备参数填写说明 参数名称 说明 所属产品 选择在步骤3中创建的产品。 设备标识码 即node_id，填写为设备的IMEI、MAC地址或Serial No；若没有真实设备，填写自定义字符串，由英文字母和数字组成。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
