检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
配置文件上传功能 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏，选择“设备 > 所有设备”，单击“文件上传”页签。 单击“服务授权”，在新弹出的页面中单击“同意授权”。 图2 文件上传-授权 注：如用户仅授权过设备接入服务访问对象存储服务的权限，可在控制台选择“设备
eport”，其中{device_id}与注册设备时获取的设备ID保持一致，您可以使用真实设备上报属性。在下方填写上报的属性，单击Publish按钮。具体可参考设备属性上报。 在控制台“设备列表”中找到该设备，单击“查看”，进入设备详情页。在设备详情页看到最新上报的数据。您也可以
设备的服务ID，由创建的产品模型确定。 properties 必选 Object 参数解释： 设备服务的属性列表，具体字段在设备关联的产品模型中定义，可以设置多个字段。 event_time 可选 String 参数解释： 设备采集数据UTC时间（格式可选：秒级别：yyyyMMdd'T'HHmmss'Z'，毫秒级别：
冻结设备 功能介绍 应用服务器可调用此接口冻结设备，设备冻结后不能再连接上线，可以通过解冻设备接口解除设备冻结。注意，当前仅支持冻结与平台直连的设备。该接口仅支持冻结单个设备，如需批量冻结设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/i
设备状态触发：可以将设备的上下线状态作为触发条件，如：设备离线持续时长达到5分钟，上报告警。 选择产品：选择特定产品。 选择设备范围： 全部设备：对选择产品下的全部设备进行条件设置。 指定设备：对选择产品下的指定设备进行条件设置。 选择触发设备状态： 上线：设备由离线状态转变为在线状态。 下线：设备由在线状态转变为离线状态。
设备信息上报 功能描述 设备向平台上报设备信息。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 网关设备上报时，子设备
删除设备 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备，则必须把设备下的非直连设备都删除后，才能删除该设备。该接口仅支持删除单个设备，如需批量删除设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI DELETE /v5/
下发设备消息 功能介绍 物联网平台可向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果，建议用户应用通过订阅设备消息状态变更通知，订阅后平台会将设备接收结果推送给订阅的应用。
表3 响应Body参数 参数 参数类型 描述 device_id String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 messages Array of DeviceMessage objects 设备消息列表。 表4 DeviceMessage 参数
系统格式下发消息字段表 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 平台下发时，若为直连设备，不携带该参数。 平台下发时，若为网关子设备，该参数为Topic中设备的子设备Id。 name 可选 String 参数解释： 消息名称，可不填写，做说明用。
String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 device_name String 设备名称。 node_type
平台命令下发 功能介绍 用于平台向设备下发设备控制命令。平台下发命令后，需要设备及时将命令的执行结果返回给平台，如果设备没回响应，平台会认为命令执行超时。命令下发和消息下发的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网
”。 设备群组可以参考群组与标签创建需要升级的设备群组，并绑定对应的设备。 图4 新建软件升级任务-选择设备群组 创建完批量升级任务后，可以在软件升级任务列表中查看批量任务的执行结果。单击对应任务“详情”按钮，可以在“执行详情”界面查看每个设备的升级结果。 如果升级任务正在执行中
请检查设备侧。 Task Conflict 任务冲突 请检查当前设备是否有软件升级、固件升级、日志收集或设备重启的任务正在进行。 Waiting for the device online timeout 等待设备上线超时 请检查设备侧。 Wait for the device to
设备自注册 概述 自注册模板主要用于设备自动注册的场景，不需要提前在物联网平台进行注册设备。当前物联网平台基于安全考虑，需要将设备的基本信息（例如设备ID、鉴权信息）注册到平台后，设备才能连接上平台。当用户的设备未在平台注册时，可以通过自注册模板在设备首次接入物联网平台时将设备信
设备鉴权 概述 LwM2M/CoAP协议鉴权 MQTT(S)协议-密钥鉴权 MQTT(S)协议-证书鉴权 MQTT(S)协议-自定义鉴权 MQTT(S)协议-自定义模板鉴权 MQTT(S)协议-OCSP与OCSP装订 父主题： 设备接入
图2 设备-注册设备成功 若密钥丢失，可以按照设备认证凭证管理中的步骤更新设备密钥，无法找回注册设备时生成的密钥。 用户可在设备列表删除不再使用的设备。删除设备不支持撤回，请谨慎操作。 相关API参考 查询设备列表 创建设备 查询设备 修改设备 删除设备 重置设备密钥 父主题： 注册设备
String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 device_name String 设备名称。 node_type
策略会允许该资源空间下所有设备的非$oc开头的自定义Topic的订阅与发布。当业务场景不适用时，可以删除该策略。 图1 策略概念图 使用场景 群组通信场景，如设备A、设备B、设备C属于一个群组，只允许设备A、设备B、设备C订阅该群组的Topic，其他设备不允许订阅该Topic。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
