检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
单个MQTT连接每秒最大上行消息数量为50条（一次请求为一条）。 使用说明 图2 设备消息上报操作流程 创建产品与设备：创建产品流程、创建设备流程。 设备鉴权：平台验证设备是否具有接入权限。 设备消息上报：设备通过MQTT/HTTPS等协议发送消息数据。 按照不同的设备协议，调用的接口不一样，下面分别介绍MQTT、HTTPS协议消息上报的样例：
查询设备组设备列表 功能介绍 应用服务器可调用此接口查询指定设备组下的设备列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/device-group/{group_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述
解冻设备 功能介绍 应用服务器可调用此接口解冻设备，解除冻结后，设备可以连接上线。该接口仅支持解冻单个设备，如需批量解冻设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/devices/{device_id}/unfreeze
$oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。
command_id String 设备命令ID，用于唯一标识一条命令，在下发设备命令时由物联网平台分配获得。 service_id String 设备命令所属的设备服务ID，在设备关联的产品模型中定义。 command_name String 设备命令名称，在设备关联的产品模型中定义。 expire_time
概述 设备接入流程图 图1 设备接入流程图 设备接入协议 华为云物联网平台支持多种接入方式和接入协议，满足各类设备和接入场景要求。请根据设备类型，选择合适方式接入到平台。 表1 协议清单 类型 子类型 协议编码 版本 适用场景 指导链接 通用协议 直连云端 MQTT/MQTTS 5
通过设备发放实现批量设备自动注册 场景说明 当前物联网平台基于安全考虑，需要将设备的基本信息（例如设备ID、鉴权信息）注册到平台后，设备才能连接上平台。当用户的设备数不断增多时，如何安全且快速的注册设备尤为关键，需要采用安全的批量注册的场景。本文基于设备发放注册组功能，使用证书策
辅密钥与主密钥有相同的效力；辅密钥对coap协议接入的设备不生效。 响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 device_id String 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分配时，生成规则为"product_id"
支持创建设备的“影子”。设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步设备属性值，这个同步可以是影子同步给设备，也可以是设备同步给影子。 设备影子上有desired区和reported区。
使用设备发放服务跨实例同步设备时，如果是指定资源空间和设备同步，同步数据仅包括设备连接新实例认证需要的身份信息，包括产品、证书和设备；不包括原实例中的设备分组、服务端订阅、规则引擎配置和平台日志等；支持同步设备的状态。 目前除了支持资源空间和设备的同步，还能指定插件的同步。 设备同步成功后，可以通过设
String 设备标识码，通常使用IMEI、MAC地址或Serial No作为node_id。 gateway_id String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，ga
设备影子 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 - 每个设备有且只有一个设备影子，由设备ID唯一标识 - 设备影子用于存储设备上报的属性和应用程序期望的设备属性 - 无论该设备是否在线，都可以通过该影子获取和设置设备的状态 查询设备影子数据
access_token 是 String Header 参数解释: 调用设备鉴权信息返回的access_token。 取值范围: 长度1-256。 device_id 是 String Path 参数解释: 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分
设备时间同步响应 功能描述 平台向设备发送时间同步响应，携带设备发送时间device_send_time。当平台收到时间server_recv_time 后，向设备发送时间server_send_time 。 例如，设备收到的设备侧时间为device_recv_time ，则设备计算自己的准确时间为：
单击实例卡片进入。 在左侧导航栏选择“设备 > 所有设备”，单击对应设备的“详情”进入设备详情页面。 图4 设备列表-详情 在设备详情页面中选择“设备影子”，在该页面可查看属性值。 图5 设备影子-SL651设备 父主题： SL651协议接入
MQTT(S)协议-证书鉴权是指在设备接入物联网平台前，用户通过控制台上传设备CA证书，然后应用服务调用创建设备接口或通过控制台在物联网平台注册设备，获取设备ID。在设备接入物联网平台时携带设备侧X.509证书（一种用于通信实体鉴别的数字证书），完成设备的接入鉴权。 约束与限制 当前
母和数字组成。 设备名称 自定义。 设备认证类型 选择“密钥”。 密钥 设备密钥，可自定义，不填写物联网平台会自动生成。 配置设备影子 用户可以选择在应用侧调用配置设备影子预期数据接口设置设备影子，也可以在设备接入控制台设置设备影子。此处以在设备接入控制台设置设备影子为例。 登录
0X00处理成功。 0X80升级任务不存在。 执行升级消息 请求消息： 方向：平台->设备 字段 数据类型 描述及要求 无数据区 响应消息： 方向：设备->平台 字段 数据类型 描述及要求 结果码 BYTE 0X00处理成功。 0X01设备使用中。 0X04电量不足。 0X05剩余空间不足。
参数说明：设备代理名称 proxy_devices 否 Array of strings 参数说明：代理设备列表，列表内所有设备共享网关权限，即列表内任意一个网关下的子设备可以通过组里任意一个网关上线然后进行数据上报。 取值范围：列表内填写设备id，列表内最少有2个设备id，最多
创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则，用于子设备自主选择网关设备上线和上报消息，即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
