检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备接入 概述 设备鉴权 开放协议接入 泛协议接入 自定义设备侧域名
入到网关的详情页面，选择“子设备”页签。 “子设备”页签呈现通过该网关方式接入到物联网平台的设备，可以查看子设备的状态、设备ID、设备标识码等信息。 在子设备页签中，单击具体的子设备，可以查看子设备的设备详情。 图7 设备-子设备详情 父主题： 设备管理
状态给设备影子一次，多个应用程序请求设备影子获取设备状态，即可获取设备最新状态，从而将应用程序和设备解耦。 修改设备属性值：用户通过“设备 > 设备详情 > 设备影子”修改设备的属性值。由于设备可能长时间处于离线状态，修改设备属性值的操作不能及时下发给设备。在这种情况下，物联网平
所有设备。 图1 设备-设备列表 表1 设备列表功能 功能 描述 搜索设备 根据状态、设备名称、设备标识码、设备ID、所属资源空间、所属产品和节点类型搜索具体设备。 查看设备信息 可查看设备状态、设备名称、设备标识码等，也可以单击设备对应的“详情”，查看设备详情。 删除设备 单击设备对应的“删除”。
平台设置设备属性 功能介绍 用于平台设置设备属性。设备的产品模型中定义了平台可向设备设置的属性，平台可调用此修改设备属性接口设置指定设备的属性数据。设备收到属性设置请求后，需要将执行结果返回给平台，如果设备没回响应平台会认为属性设置请求执行超时。 低配置且资源受限或者对网络流量有
查询设备影子数据 功能介绍 应用服务器可调用此接口查询指定设备的设备影子信息，包括对设备的期望属性信息（desired区）和设备最新上报的属性信息（reported区）。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备ID唯一标识
access_token 是 String Header 参数解释: 调用设备鉴权信息返回的access_token。 取值范围: 长度1-256。 device_id 是 String Path 参数解释: 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分
配置设备影子预期数据 功能介绍 应用服务器可调用此接口配置设备影子的预期属性（desired区），当设备上线或者设备上报属性时把属性下发给设备。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备ID唯一标识 设备影子
平台查询设备属性 功能介绍 用于平台向设备查询属性信息。平台可调用查询设备属性接口查询设备的属性数据。设备收到属性查询请求后，需要将设备的属性数据返回给平台，如果设备没回响应平台会认为属性查询请求执行超时。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与
下发设备命令 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果同步返回, 如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。如
已完成实名制认证。未完成可在华为云上单击实名认证完成认证，否则无法使用设备接入功能。 已开通设备接入服务。未开通则访问设备接入服务，单击“管理控制台”后开通该服务。 获取设备接入信息 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 单击左侧导航栏的“总览”，单击“当前实例
下发异步设备命令 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发异步命令，以实现对设备的控制。平台负责将命令发送给设备，并将设备执行命令结果异步通知应用服务器。 命令执行结果支持灵活的数据流转，应用服务器通过调用物联网平台的创建
设备状态触发：可以将设备的上下线状态作为触发条件，如：设备离线持续时长达到5分钟，上报告警。 选择产品：选择特定产品。 选择设备范围： 全部设备：对选择产品下的全部设备进行条件设置。 指定设备：对选择产品下的指定设备进行条件设置。 选择触发设备状态： 上线：设备由离线状态转变为在线状态。 下线：设备由在线状态转变为离线状态。
修改设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向指定设备下发属性。平台负责将属性以同步方式发送给设备，并将设备执行属性结果同步返回，如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。
弹出批量注册设备窗口，填写“任务名称”，下载并填写“批量注册设备文件模板”内容并上传文件，单击“确定”创建任务。 图1 设备-批量注册设备 批量注册执行成功，如果是原生MQTT设备注册，请单击批量任务一行，进入任务的“执行详情”，保存好设备ID和密钥，用于原生MQTT设备接入平台。
String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 device_name String 设备名称。 node_type
URI 请求方法 POST URI /v5/device-auth 传输协议 HTTPS 请求参数 名称 必选 类型 位置 说明 device_id 是 String Body 参数解释: 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网
网关批量属性上报 一次性上报多个子设备的属性，设备侧到应用侧的数据不直接透传。平台会将网关上报多子设备的数据分发到对应的子设备。 网关下关联多个子设备的场景。并且对于子设备数据上报时间不敏感，可以把多个子设备的数据打包后再一起上报。 MQTT 资源受限或者对网络流量有要求的设备，不适合直接构造
删除设备 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备，则必须把设备下的非直连设备都删除后，才能删除该设备。该接口仅支持删除单个设备，如需批量删除设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI DELETE /v5/
冻结设备 功能介绍 应用服务器可调用此接口冻结设备，设备冻结后不能再连接上线，可以通过解冻设备接口解除设备冻结。注意，当前仅支持冻结与平台直连的设备。该接口仅支持冻结单个设备，如需批量冻结设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/i
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
