旧版文档

IoT Hub/规则引擎迁移指导手册

物接入 IoT Hub （含物解析类型的 IoT Hub 实例）及配套的老版本规则引擎产品整体也将于2022年10月31日正式停止服务，你可选择使用物联网核心套件 IoT Core 下对应能力提供服务。

迁移指导

如何从物接入IoT Hub迁移至 物联网核心套件IoT Core 。我们建议您通过OTA方式对设备进行升级以适配新版本IoT Core的使用，也可提交工单获取帮助或沟通迁移方案。

数据面

接入点：IoT Core 接入点域名可以在创建实例后在详情页面获取，TCP/TLS/WSS等方式连接接入点，对应连接端口无变化。

鉴权：使用更安全的鉴权方式，需根据 devicekey 和 devicesecret 计算 MQTT 用户名密码， 查看文档 。针对迁移用户，可提交工单申请使用IoT Hub 风格（coreID/devicekey）的静态密码；若使用证书鉴权方式则无需再手动传递UserName。

系统限制：详细限制可查看文档。特别地，如使用版本为 MQTT 3.1 或未指定版本，请关注 clientID 字符长度的限制。

MQTT主题：IoT Core使用主题模板来定义设备的主题权限，相对老版本IoT Hub的实现更加扁平和简洁。具体使用请参考文档中主题模板部分，请查看文档 。

HTTP 发布：IoT Core仍然支持HTTP方式进行消息发布，使用时鉴权和传参方式有所变化，请查看文档 。

CoAP 发布：IoT Core仍然支持CoAP方式进行消息发布，使用时鉴权和传参方式有所变化，请查看文档 。

规则引擎：查询语法与老版本有所变化，新的查询语法请查看文档 。

控制面

API：如您有使用API，需要迁移适配IoT Core的新版 API，请查看文档 。

影子：暂无法兼容，请参考IoT Core新版本影子自行重新对接使用，请查看文档 。

其他

物解析：物解析型实例已于2019年公告不再提供服务，本次也将一并下线。