检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备消息 下发设备消息 查询设备消息 查询指定消息id的消息 父主题： API
概述 设备接入流程图 图1 设备接入流程图 设备接入协议 华为云物联网平台支持多种接入方式和接入协议，满足各类设备和接入场景要求。请根据设备类型，选择合适方式接入到平台。 表1 协议清单 类型 子类型 协议编码 版本 适用场景 指导链接 通用协议 直连云端 MQTT/MQTTS 5
由于PCP协议消息和设备业务消息共用一个端口和URL通讯，平台收到设备的消息时，按照如下步骤判断是PCP协议消息还是业务消息： 检查设备是否支持软件升级（根据设备profile的omCapability.upgradeCapability定义），如果不支持，则认为是业务消息。 检查设备软件升级
删除设备代理 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备代理。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/device-proxies/{proxy_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
平台下发隧道信息 功能介绍 物联网平台向设备侧下发安全隧道信息。设备侧在接收到信息后，可以使用该安全隧道信息建立与物联网平台的WebSocket连接，用户可以在应用端远程登录使用基于安全隧道建链的设备（远程SSH登录服务），进行设备的更新配置、排查诊断、运维变更等操作。 Topic
报，应用侧可通过"设备影子"查看属性值。样例如下： 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏选择“ 设备 > 所有设备”，单击“详情”进入设备详情页面。 图4 设备列表-详情 在设备详情页面选择“设备影子”，在该页面可查看属性值。
iotda:devices:publish：设备使用MQTT协议发布消息。 iotda:devices:subscribe：设备使用MQTT协议订阅消息。 resources 是 Array of strings 用于指定允许或拒绝对其执行操作的资源。格式为：资源类型:资源名称。如设备订阅的资源为：topic:/v1/${devices
String 设备组ID，用于唯一标识一个设备组，在创建设备组时由物联网平台分配。 name String 设备组名称，单个资源空间下不可重复。 description String 设备组描述。 super_group_id String 父设备组ID，该设备组的父设备组ID。 group_type
验证设备CA证书 功能介绍 应用服务器可调用此接口在物联网平台验证设备的CA证书，目的是为了验证用户持有设备CA证书的私钥 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/certificates/{certificate_id}/action
创建设备隧道 功能介绍 用户可以通过该接口创建隧道（WebSocket协议），应用服务器和设备可以通过该隧道进行数据传输。 该API接口在基础版不支持。 该API调用后平台会向对应的MQTT/MQTTS设备下发隧道地址及密钥，同时给应用服务器也返回隧道地址及密钥，设备可以通过该地
上传设备CA证书 功能介绍 应用服务器可调用此接口在物联网平台上传设备CA证书 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/certificates 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
日志信息 收到设备发放下发的设备接入地址后，需要关闭设备侧的设备发放的连接，用的新的URL地址与设备接入通信，进行相关业务。 图13 关闭连接示例代码 说明： DeviceId即设备ID，用于唯一标识一个设备。设备需使用未注册的DeviceId进行免注册接入，不同设备的DeviceId不同。
静态策略 概述 静态策略，即设备关键字模糊匹配的发放策略。每条静态策略实例指：匹配上该策略实例的设备，将会被发放到该条策略实例关联的设备接入实例的对应资源空间（即应用）下。 设备匹配静态策略实例的机制为： 设备的发放策略为“静态策略”，设备的关键字来源字符串包含某一静态策略实例的
网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。 若为空则默认该参数与Topic中的device_id一致。 services 可选
设备发放 产品介绍 证书管理 授权策略 设备发放策略 设备注册 MQTT场景--使用MQTT.fx接入设备发放示例 MQTT场景--使用华为SDK接入设备发放示例 接口说明
String 设备组ID，用于唯一标识一个设备组，在创建设备组时由物联网平台分配。 name String 设备组名称，单个资源空间下不可重复。 description String 设备组描述。 super_group_id String 父设备组ID，该设备组的父设备组ID。 group_type
String 参数解释： 设备标识。 device_id 可选 String 参数解释： 设备ID，用于唯一标识一个设备。如果携带该参数，平台将设备ID设置为该参数值；如果不携带该参数，设备ID由物联网平台分配获得，生成规则为"product_id" + "_" + "node_id"拼接而成。
选择对应产品。 设备标识码 即nodeID，设备唯一物理标识。可自定义，由英文字母和数字组成。 设备名称 即device_name，可自定义。 设备认证类型 选择“密钥”。 密钥 此处如不填写，物联网平台会自动生成。 图10 单设备注册-MQTT 成功注册设备后，平台会自动生成设备ID和密
平台通知网关子设备新增 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
创建产品，创建MQTT协议产品（如果有MQTT协议产品可直接使用）。 注册单个设备。 设备群组，将注册的设备加入一个设备群组(创建升级任务时会用到)。 上传升级包 访问设备接入服务，单击“立即使用”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏选择“设备 > 软固件升级”。 选择"资源包管理"页签，选择"固件列表"。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
