概述

本文介绍如何通过控制台创建和管理 IoT Core 实例的模板。

创建模板

1. 登录物联网核心套件控制台。
2. 进入“实例列表”，点击您要创建模板的 实例名称 ，进入实例详情页面。

3. 在实例详情页面的左侧导航栏，选择 模板，进入模板列表页面。

   

4. 点击 添加模板，在添加模板弹窗中输入“模板名称”，点击 确认，页面提示“模板添加成功”。

   

主题模板

1. 在实例详情页面页面，点击左侧导航栏中的 模板 按钮，进入模板列表页面。

2. 点击已创建的 模板名称/ID，进入模板详情页面。

   

3. 在页面的 主题模板 页面下，提供对 MQTT 主题的描述。模板创建后，可由设备或者应用使用。默认的模板包含两个的设备主题。

   分别用于：

   • $iot/{deviceName}/events 用于设备客户端向云端发布（Pub）消息
   • $iot/{deviceName}/msg 用于订阅（Sub）云端发往设备客户端的消息
4. 模板允许增删主题，可根据使用需求进行操作。模板内主题增删操作后将在5分钟内生效。

增加主题

标准模式

说明：如需为服务端应用定义主题，请使用高级模式。

1. 如需增加自定义主题，创建一个新模板，进入后选择 添加主题。

2. 在标准模式下，添加主题，设置主题权限“发布（PUB）”或“订阅（SUB）”。
   例如添加一个发布和订阅均允许的主题 $iot/{deviceName}/user/fortest

   

   参数说明：

   • 主题名：主题名不超过256个字符，仅支持ASCII字符，不支持中文，不支持$开头的系统主题。最多3层，可使用#或+通配符。
   • 其中 {deviceName} 为变量，表示使用对应设备连接时，应替换为设备名称。
   • 如创建设备时名称为 mydevice1，则根据配置，此设备对 $iot/mydevice1/user/fortest 主题可进行订阅或发布操作。

3. （选填）描述信息，为该主题的内容添加描述信息。

4. 点击 确定，页面提示“添加成功”，完成标准模式主题的创建。

   

高级模式

注意：此模式下需注意分配合理的主题及权限，避免安全风险。我们建议，仅当在您充分了解 MQTT 协议本身情况下使用高级模式。

1. 点击 主题模板 页面下的 添加主题。

2. 选择 高级模式，填写“主题名称”，主题名不超过256个字符，最长定义5层，不支持$开头的系统主题。可以使用通配符 # 或 +，其中通配符的使用需符合 MQTT 3.1.1 标准协议及IoT Core 产品统一系统限制的要求。

   

3. 设置主题权限“发布（PUB）”或“订阅（SUB）”。
4. （选填）描述信息，为该主题的内容添加描述信息。
5. 点击 确定，页面提示“添加成功”，完成高级模式主题的创建。

示例：

期望在服务器端使用，对所有主题有 pub/sub 权限，则可新建一个模板，定义其对 # (即所有主题)有订阅及发布权限。特别地，需注意使用此模板创建的设备权限过高，请确保其 key 不被泄露。

删除主题

模板中的主题如不再使用，可进行删除。

1. 在实例详情页面页面，点击左侧导航栏中的 模板 按钮，进入模板列表页面。
2. 点击已创建的 模板名称/ID，进入模板详情页面。
3. 在页面的 主题模板 页面下，选择想要删除的主题，点击其操作栏的 删除 按钮。
4. 在弹出的确认框中点击 确定，页面提示“删除策略成功”，完成主题的删除操作。

影子模板

邀测中，暂未开放。