检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
配置文件上传功能 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏，选择“设备 > 所有设备”，单击“文件上传”页签。 单击“服务授权”，在新弹出的页面中单击“同意授权”。 图2 文件上传-授权 注：如用户仅授权过设备接入服务访问对象存储服务的权限，可在控制台选择“设备
设备管理 创建产品 注册设备 管理设备 群组和标签 设备高级搜索 设备影子 OTA升级 文件上传 网关与子设备 设备代理 设备认证凭证管理 设备证书
设备侧获取平台的设备影子数据 功能介绍 用于设备向平台获取设备影子数据。用户可以通过应用服务器或物联网控制台配置设备影子预期数据，设备上线时订阅该topic，可以获取到平台设备影子数据，以此来同步设备属性期望值，从而完成设备属性值的修改。 简单交互逻辑介绍如下： ① 应用调用“配
协议接入。 设备接入鉴权 支持一机一密，X.509证书等鉴权方式。 泛协议接入 提供开源SDK和技术框架，需用户自行部署云网关完成TCP协议转换，或部署协议驱动到边缘网关。 设备管理 设备全生命周期管理 设备增删改查、设备状态管理、设备冻结/解冻、子设备管理等。 设备分组&标签
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个，建议分不同批次进行上报。
查询设备组设备列表 功能介绍 应用服务器可调用此接口查询指定设备组下的设备列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/device-group/{group_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述
网关新增子设备请求 功能介绍 网关主动新增其下接入的子设备，在平台上完成开户。网关与子设备关系，请查看网关与子设备。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
查询设备隧道 功能介绍 用户可通过该接口查询某项目中的某个设备隧道，查看该设备隧道的信息与连接情况。应用服务器可调用此接口向平台查询设备隧道建立情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET
平台通知网关子设备新增 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
解冻设备 功能介绍 应用服务器可调用此接口解冻设备，解除冻结后，设备可以连接上线。该接口仅支持解冻单个设备，如需批量解冻设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/devices/{device_id}/unfreeze
014016和IOTDA.014112。IOTDA.014016表示设备不在线；IOTDA.014112表示设备没有订阅topic。 error_msg String 参数说明：异常信息说明，包含设备不在线和设备没有订阅topic说明。 请求示例 查询指定的消息详情。 GET https://{en
可选择时间范围 注册设备数 统计当前实例的总注册设备数。 每小时 小时、日、月 同时在线设备数 统计当前实例的同时在线设备数。小时维度：统计每小时的最大在线设备数，天维度：统计每天的最大在线设备数。 每小时 小时、日、月 设备消息数 统计当前实例的设备上下行消息数。设备上行消息数包含消息、
物联网平台向设备下发命令 物联网平台接收设备回复的命令响应 设备属性 物联网平台接收应用侧修改设备属性的请求 物联网平台向设备修改属性 物联网平台接收设备上报的属性 物联网平台接收网关批量上报的设备属性 设备事件 物联网平台通知网关设备新增的事件 物联网平台通知网关设备删除的事件 物联网平台接收网关同步子设备列表的事件
设备属性上报 功能介绍 用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。
object_device_id 可选 String 参数解释： 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。
物联网平台接收设备上报的消息 设备命令 物联网平台接收应用侧下发设备命令的请求 物联网平台向设备下发命令 物联网平台接收设备回复的命令响应 设备属性 物联网平台接收应用侧修改设备属性的请求 物联网平台向设备修改属性 物联网平台接收设备上报的属性 物联网平台接收网关批量上报的设备属性 设备事件
网关同步子设备列表 功能介绍 网关设备从平台同步子设备列表。网关设备不在线时，平台无法将子设备新增和删除的信息及时通知到网关设备。网关设备离线再上线时，可以通过此接口从平台同步这段时间内新增或者删除的子设备信息。新增的子设备信息会通过平台通知网关子设备新增接口通知网关设备，删除的子
请求数)。 单实例最大支持创建10个设备代理。 一个设备代理中最多能添加10个设备。 仅支持直连/网关设备加入设备代理，子设备不允许添加至设备代理中。 一个设备仅允许加入一个设备代理中。 样例演示 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
测试验证步骤如下： 设备端运行设备侧 SDK代码，设备侧属性上报日志格式样例如下： 图5 java SDK属性上报结果log 进入设备接入控制台，选择“设备 > 所有设备”，单击具体设备，在“设备信息”页签中可看到最新的上报数据。 图6 属性上报-查看数据 父主题： 设备数据上报
过这些接口，平台和设备可以实现设备鉴权、消息上报及属性上报。 消息类型 说明 设备鉴权 用于设备获取鉴权信息access_token。 设备属性上报 用于设备按产品模型中定义的格式将属性数据上报给平台。 设备消息上报 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
