检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
由于PCP协议消息和设备业务消息共用一个端口和URL通讯，平台收到设备的消息时，按照如下步骤判断是PCP协议消息还是业务消息： 检查设备是否支持软件升级（根据设备profile的omCapability.upgradeCapability定义），如果不支持，则认为是业务消息。 检查设备软件升级
报，应用侧可通过"设备影子"查看属性值。样例如下： 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏选择“ 设备 > 所有设备”，单击“详情”进入设备详情页面。 图4 设备列表-详情 在设备详情页面选择“设备影子”，在该页面可查看属性值。
删除设备代理 功能介绍 应用服务器可调用此接口在物联网平台上删除指定设备代理。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/device-proxies/{proxy_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
设备与其接入服务器之间已有通信网络，您希望在不修改设备和协议的情况下，将设备接入IoT平台。 由于设备硬件资源或者网络限制，设备无法直接接入IoT平台。 方案架构 方案总体架构框图如下： 图1 总体架构图 各种不同协议类型的设备，通过泛协议插件，最终以MQTT协议和华为云物联网平台进行链接。泛协议插
网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。 直连设备上报时，object_device_id需与Topic中的device_id一致。 若为空则默认该参数与Topic中的device_id一致。 services
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
网关新增子设备请求响应 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备，平台收到网关新增子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down
创建设备隧道 功能介绍 用户可以通过该接口创建隧道（WebSocket协议），应用服务器和设备可以通过该隧道进行数据传输。 该API接口在基础版不支持。 该API调用后平台会向对应的MQTT/MQTTS设备下发隧道地址及密钥，同时给应用服务器也返回隧道地址及密钥，设备可以通过该地
选择左侧导航栏的“设备 > 所有设备”，单击“注册设备”，填写设备注册参数。填写完成后单击“确定”，请注意保存注册成功返回的“设备ID”和“设备密钥”。 图3 单设备注册-gateway 表2 注册设备参数填写说明 参数名称 说明 所属产品 选择在步骤4中创建的产品。 设备标识码 即n
上传设备CA证书 功能介绍 应用服务器可调用此接口在物联网平台上传设备CA证书 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/certificates 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
完成自定义策略函数的编写后，创建关联该函数的自定义策略实例以及设备或注册组，通过设备南向操作触发函数，将设备发放到指定目的接入点（设备接入实例）。 后续操作包括： 添加自定义策略实例； 注册设备或创建注册组； 南向接口：MQTT CONNECT连接鉴权、设备请求引导消息、设备接收引导消息。 最佳实践： 结合函
策略会允许该资源空间下所有设备的非$oc开头的自定义Topic的订阅与发布。当业务场景不适用时，可以删除该策略。 图1 策略概念图 使用场景 群组通信场景，如设备A、设备B、设备C属于一个群组，只允许设备A、设备B、设备C订阅该群组的Topic，其他设备不允许订阅该Topic。
设备属性 修改设备属性 查询设备属性 父主题： API
设备命令 设备同步命令 设备异步命令 父主题： API
设备消息 下发设备消息 查询设备消息 查询指定消息id的消息 父主题： API
509证书认证，并关联已认证的设备CA证书； 3. 开发设备端，将X.509证书及其私钥烧录到设备上； 4. 设备在与平台双向认证过程中，设备验证平台证书，平台使用设备CA证书验证设备证书并验证设备证书与设备的关联关系。 X.509双向证书认证 X.509证书双向认证过程，涉及到设备发放（平台）和设备两端，过程如下图所示。
设备发放策略 自定义策略 证书策略 静态策略 父主题： 设备发放
选择对应产品。 设备标识码 即nodeID，设备唯一物理标识。可自定义，由英文字母和数字组成。 设备名称 即device_name，可自定义。 设备认证类型 选择“密钥”。 密钥 此处如不填写，物联网平台会自动生成。 图10 单设备注册-MQTT 成功注册设备后，平台会自动生成设备ID和密
设备命令 平台命令下发 父主题： 设备侧MQTT/MQTTS接口参考
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
