检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
删除设备 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备，则必须把设备下的非直连设备都删除后，才能删除该设备。该接口仅支持删除单个设备，如需批量删除设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI DELETE /v5/
系统格式下发消息字段表 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 平台下发时，若为直连设备，不携带该参数。 平台下发时，若为网关子设备，该参数为Topic中设备的子设备Id。 name 可选 String 参数解释： 消息名称，可不填写，做说明用。
List<DeviceProperty> Body 参数解释: 设备数据列表。 取值范围: 长度不超过50。 表1 DeviceProperty 名称 必选 类型 说明 device_id 是 String 参数解释: 子设备的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 取值范围:
下发设备消息 功能介绍 物联网平台可向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果，建议用户应用通过订阅设备消息状态变更通知，订阅后平台会将设备接收结果推送给订阅的应用。
注册设备 注册单个设备 批量注册设备 注册X.509证书认证的设备 设备自注册 父主题： 设备管理
制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 device_id String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 messages
设备自注册 概述 自注册模板主要用于设备自动注册的场景，不需要提前在物联网平台进行注册设备。当前物联网平台基于安全考虑，需要将设备的基本信息（例如设备ID、鉴权信息）注册到平台后，设备才能连接上平台。当用户的设备未在平台注册时，可以通过自注册模板在设备首次接入物联网平台时将设备信
图2 设备-注册设备成功 若密钥丢失，可以按照设备认证凭证管理中的步骤更新设备密钥，无法找回注册设备时生成的密钥。 用户可在设备列表删除不再使用的设备。删除设备不支持撤回，请谨慎操作。 相关API参考 查询设备列表 创建设备 查询设备 修改设备 删除设备 重置设备密钥 父主题： 注册设备
只能同时对1个设备进行升级。 如果用户在软件升级中发现同时进行升级的设备数较少，则可以联系当地运营商检查和优化设备所在小区的无线覆盖情况。 查询失败：则按照流程9进行处理。 9. 物联网平台继续下发查询小区ID信息的命令，获取终端设备所在的小区ID信息。 如果查询成功：物联网平台
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个，建议分不同批次进行上报。
配置文件上传功能 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏，选择“设备 > 所有设备”，单击“文件上传”页签。 单击“服务授权”，在新弹出的页面中单击“同意授权”。 图2 文件上传-授权 注：如用户仅授权过设备接入服务访问对象存储服务的权限，可在控制台选择“设备
息完成接入鉴权。 设备名称 设备发放时，设备名称将作为主要的筛选条件之一，建议按照统一的规则规划不同地区的设备名称。 例如：北京地区设备，设备名称都携带Beijing；香港地区设备，设备名称都携带Hongkong。 设备ID 设备ID默认为产品ID+“_”+设备标识码，用户也可自己定义。
设备联动规则 批量任务为应用服务器提供批量处理功能，对接入物联网平台的设备进行批量操作。 创建规则 查询规则列表 修改规则 查询规则 删除规则 修改规则状态 父主题： API
钟）。 设备状态触发：可以将设备的上下线状态作为触发条件，如：设备离线持续时长达到5分钟，上报告警。 选择产品：选择特定产品。 选择设备范围： 全部设备：对选择产品下的全部设备进行条件设置。 指定设备：对选择产品下的指定设备进行条件设置。 选择触发设备状态： 上线：设备由离线状态转变为在线状态。
设备属性上报 功能介绍 用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。
object_device_id 可选 String 参数解释： 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。
查询设备隧道 功能介绍 用户可通过该接口查询某项目中的某个设备隧道，查看该设备隧道的信息与连接情况。应用服务器可调用此接口向平台查询设备隧道建立情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET
测试验证步骤如下： 设备端运行设备侧 SDK代码，设备侧属性上报日志格式样例如下： 图5 java SDK属性上报结果log 进入设备接入控制台，选择“设备 > 所有设备”，单击具体设备，在“设备信息”页签中可看到最新的上报数据。 图6 属性上报-查看数据 父主题： 设备数据上报
自注册日志 用户可以在设备接入控制台看到已发放的设备数目。 图16 查看已发放的设备数目列表 用户可以通过右上角的“所有状态”来过滤“在线”的设备，可以看到在线设备数一直在增长。 图17 设备在线状态 用户可以回到设备发放控制台，看到SDK默认创建好的证书策略。 图18 设备发放证书策略 用户可以看到SDK默认创建的注册组。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
