检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
String 参数说明：设备代理ID。用来唯一标识一个代理规则 proxy_name String 参数说明：设备代理名称 proxy_devices Array of strings 参数说明：代理设备组，组内所有设备共享网关权限，即组内任意一个网关下的子设备可以通过组里任意一个网关上线然后进行数据上报。
MQTT(S)协议-密钥鉴权 概述 MQTT(S)协议-密钥鉴权是指设备在接入物联网平台时，携带设备ID和密钥以完成设备的接入鉴权。对于使用MQTTS协议接入的设备，需要在设备侧预置CA证书；对于使用MQTT非安全协议接入的设备，无需在设备侧预置CA证书。 使用MQTT(S)协议-密钥接入的鉴权流程
义，由英文字母和数字组成。 设备名称 即device_name，可自定义。 设备认证类型 选择“密钥”。 密钥 设备密钥，可自定义，不填写物联网平台会自动生成。 图10 所有设备-注册设备 成功注册设备后，平台会自动生成设备ID和密钥，请妥善保管好设备ID（deviceId）和密
过这些接口，平台和设备可以实现设备鉴权、消息上报及属性上报。 消息类型 说明 设备鉴权 用于设备获取鉴权信息access_token。 设备属性上报 用于设备按产品模型中定义的格式将属性数据上报给平台。 设备消息上报 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用
iotda:devices:publish：设备使用MQTT协议发布消息。 iotda:devices:subscribe：设备使用MQTT协议订阅消息。 resources Array of strings 用于指定允许或拒绝对其执行操作的资源。格式为：资源类型:资源名称。如设备订阅的资源为：topic:/v1/${devices
者在控制台上注册设备。 物联网平台向设备分配密钥，返回timeout。 密钥可以在注册设备时自定义，如果没有定义，平台将自动分配预置密钥。 timeout是指超时时间，若设备在有效时间未接入物联网平台，则平台会删除该设备的注册信息。 设备登录时，安全设备携带设备唯一标识码node
请求数)。 单实例最大支持创建10个设备代理。 一个设备代理中最多能添加10个设备。 仅支持直连/网关设备加入设备代理，子设备不允许添加至设备代理中。 一个设备仅允许加入一个设备代理中。 样例演示 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
通过设备发放实现批量设备自动注册 场景说明 当前物联网平台基于安全考虑，需要将设备的基本信息（例如设备ID、鉴权信息）注册到平台后，设备才能连接上平台。当用户的设备数不断增多时，如何安全且快速的注册设备尤为关键，需要采用安全的批量注册的场景。本文基于设备发放注册组功能，使用证书策
设备状态变更、批量任务状态变更等消息推送到您指定的服务器。详情请参见订阅推送方式概述。 设备影子 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获
String 设备组ID，用于唯一标识一个设备组，在创建设备组时由物联网平台分配。 name String 设备组名称，单个资源空间下不可重复。 description String 设备组描述。 super_group_id String 父设备组ID，该设备组的父设备组ID。 group_type
母和数字组成。 设备名称 自定义。 设备认证类型 选择“密钥”。 密钥 设备密钥，可自定义，不填写物联网平台会自动生成。 配置设备影子 用户可以选择在应用侧调用配置设备影子预期数据接口设置设备影子，也可以在设备接入控制台设置设备影子。此处以在设备接入控制台设置设备影子为例。 登录
在物联网平台中，设备注册时，需要填写设备标识码（即nodeId）。设备标识码是设备的物理标识，通常使用IMEI或MAC地址。设备ID（deviceId）是物联网平台对设备的逻辑标识。 NB-IoT设备：在设备接入物联网平台时携带设备标识码（nodeId），完成设备的接入鉴权。 MQTT设备：在设备接入物联网
参数说明：资源空间ID。此参数为非必选参数，存在多资源空间的用户需要使用该接口时，可以携带该参数查询指定资源空间下的设备策略，不携带该参数则会查询该用户下所有设备策略。 取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。 policy_name 否 String
息完成接入鉴权。 设备名称 设备发放时，设备名称将作为主要的筛选条件之一，建议按照统一的规则规划不同地区的设备名称。 例如：北京地区设备，设备名称都携带Beijing；香港地区设备，设备名称都携带Hongkong。 设备ID 设备ID默认为产品ID+“_”+设备标识码，用户也可自己定义。
以NB-IoT场景为例，编解码插件将设备上报的二进制数据解码为JSON格式供应用服务器“阅读”，将应用服务器下行的JSON格式命令编码为二进制格式数据供终端设备（UE）“理解执行”。NB-IoT设备和物联网平台之间采用CoAP协议通讯，CoAP消息的payload为应用层数据，应用层数据的格式由设备自行定义
String 网关ID，用于标识设备所属的父设备，即父设备的设备ID。当设备是直连设备时，gateway_id与设备的device_id一致。当设备是非直连设备时，gateway_id为设备所关联的父设备的device_id。 device_name String 设备名称。 node_type
access_token 是 String Header 参数解释: 调用设备鉴权信息返回的access_token。 取值范围: 长度1-256。 device_id 是 String Path 参数解释: 设备ID，用于唯一标识一个设备。在注册设备时直接指定，或者由物联网平台分配获得。由物联网平台分
decode接口的入参binaryData为设备发过来的CoAP报文的payload部分。 设备的上行报文有两种情况需要插件处理（消息④是模组回复的协议ACK，无需插件处理）： 设备上报数据（对应图中的消息①） 字段名 类型 是否必填 参数描述 identifier String 否 设备在应用协议里的标识
单个MQTT连接每秒最大上行消息数量为50条（一次请求为一条）。 使用说明 图2 设备消息上报操作流程 创建产品与设备：创建产品流程、创建设备流程。 设备鉴权：平台验证设备是否具有接入权限。 设备消息上报：设备通过MQTT/HTTPS等协议发送消息数据。 按照不同的设备协议，调用的接口不一样，下面分别介绍MQTT、HTTPS协议消息上报的样例：
description String 设备组描述。 super_group_id String 父设备组ID，该设备组的父设备组ID。 group_type String 参数说明：设备组类型，默认为静态设备组；当设备组类型为动态设备组时，需要填写动态设备组规则 请求示例 POST ht
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
