检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
可以将修改设备的属性信息存储在设备影子中，待设备上线后，将修改的设备属性值同步给设备，从而完成设备属性值的修改。 业务流程 修改设备属性值 修改desired区属性值，如果设备在线，则设备影子直接同步设备属性值到设备，否则等待设备上线或上报数据时，再同步设备属性值到设备。 用户通
所有设备。 图1 设备-设备列表 表1 设备列表功能 功能 描述 搜索设备 根据状态、设备名称、设备标识码、设备ID、所属资源空间、所属产品和节点类型搜索具体设备。 查看设备信息 可查看设备状态、设备名称、设备标识码等，也可以单击设备对应的“详情”，查看设备详情。 删除设备 单击设备对应的“删除”。
URI 请求方法 POST URI /v5/device-auth 传输协议 HTTPS 请求参数 名称 必选 类型 位置 说明 device_id 是 String Body 参数解释: 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网
入到网关的详情页面，选择“子设备”页签。 “子设备”页签呈现通过该网关方式接入到物联网平台的设备，可以查看子设备的状态、设备ID、设备标识码等信息。 在子设备页签中，单击具体的子设备，可以查看子设备的设备详情。 图5 设备-子设备详情 父主题： 设备管理
查询设备影子数据 功能介绍 应用服务器可调用此接口查询指定设备的设备影子信息，包括对设备的期望属性信息（desired区）和设备最新上报的属性信息（reported区）。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备ID唯一标识
设备接入 概述 设备鉴权 开放协议接入 泛协议接入 自定义设备侧域名 平台云云对接
access_token 是 String Header 参数解释: 调用设备鉴权信息返回的access_token。 取值范围: 长度1-256。 device_id 是 String Path 参数解释: 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分
配置设备影子预期数据 功能介绍 应用服务器可调用此接口配置设备影子的预期属性（desired区），当设备上线或者设备上报属性时把属性下发给设备。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备ID唯一标识 设备影子
修改设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向指定设备下发属性。平台负责将属性以同步方式发送给设备，并将设备执行属性结果同步返回。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
配置文件上传功能 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏，选择“设备 > 所有设备”，单击“文件上传”页签。 单击“服务授权”，在新弹出的页面中单击“同意授权”。 图2 文件上传-授权 注：如用户仅授权过设备接入服务访问对象存储服务的权限，可在控制台选择“设备
String 设备标识码，通常使用IMEI、MAC地址或Serial No作为node_id。 gateway_id String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，ga
平台查询设备属性 功能介绍 用于平台向设备查询属性信息。平台可调用查询设备属性接口查询设备的属性数据。设备收到属性查询请求后，需要将设备的属性数据返回给平台，如果设备没回响应平台会认为属性查询请求执行超时。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与
设备信息上报 功能描述 设备向平台上报设备信息。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 网关设备上报时，子设备
下发设备命令 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果同步返回, 如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。如
平台设置设备属性 功能介绍 用于平台设置设备属性。设备的产品模型中定义了平台可向设备设置的属性，平台可调用此修改设备属性接口设置指定设备的属性数据。设备收到属性设置请求后，需要将执行结果返回给平台，如果设备没回响应平台会认为属性设置请求执行超时。 低配置且资源受限或者对网络流量有
指定的） 设备侧跟云端之间TCP链路断开，导致设备离线 物联网平台收到设备侧发送的TCP拆链报文，导致设备侧与物联网平台之间的TCP链路断开。 删除设备导致链路断开，设备离线 租户在物联网平台上对该设备进行删除，物联网平台对该设备进行断链。 冻结设备导致链路断开，设备离线 租户在
object_device_id 可选 String 参数解释： 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。
批量注册设备 物联网平台支持通过应用服务器调用创建批量任务接口，或者在控制台上批量注册设备。本文介绍如何在控制台上批量注册设备。 操作步骤 访问设备接入服务，单击“管理控制台”进入设备接入控制台。 在左侧导航栏选择“设备 > 所有设备”，进入“批量注册”页签，单击“批量注册”。
下行：$oc/devices/{device_id}/sys/messages/down 参数说明 表1 系统格式下发消息字段表 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 平台下发时，若为直连设备，不携带该参数。 平台下发时，若为网关子设备，该参数为Topic中设备的子设备Id。
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
