# 订阅主题 #### 操作场景 要接收发布至主题的消息，您必须向该主题添加订阅者。 #### 操作步骤 1. 登录[SMN控制台](https://console.huaweicloud.com/smn/?#/dashboard)。 2. 在左侧导航栏，选择"主题管理" \> "主题"。 进入主题页面。 3. 在主题列表中，选择您要向其添加订阅者的主题，在右侧"操作"栏单击"添加订阅"。 或者单击"主题名称"，在主题详情页的右上角选择"添加订阅"。 此时将显示"添加订阅"对话框。 图1添加订阅 ![](https://support.huaweicloud.com/usermanual-smn/zh-cn_image_0000001928825201.png "点击放大") 4. 在"协议"下拉框中选择您需要的协议，在"订阅终端"输入框中输入对应的订阅终端，填写说明如[表1]所示。 表1添加订阅参数说明 | **参数** | **说明** | |:---|:---| | 主题名称 | 在弹出的对话框中选择的主题的名称。 | | 协议 | 在下拉框中选择需要订阅终端支持的协议，提供的选项为"短信"、"邮件"、"HTTP"、"HTTPS"、"FunctionGraph（函数）"、"FunctionGraph（工作流）"、"语音通知"、"钉钉机器人"、"企业微信机器人"、"飞书机器人"、"Welink（红版）"、"Welink机器人"。 说明： - 其中，"语音通知"、"钉钉机器人"、"企业微信机器人"、"飞书机器人"、"Welink（红版）"、"Welink机器人"当前是公测功能，如果需要使用请提交工单申请开通公测。 - 开通公测后，会导致用户当前token失效，需要重新登录才能继续使用（使用API调用时，需要重新获取token）。 - 企业微信群消息，钉钉群消息，飞书群消息有发送条数限制和接收方系统故障情况，可能会导致消息发送失败。 当出现上述原因时，SMN不保证消息成功送达。 | | 添加方式 | 支持"新建订阅"和"导入订阅"两种方式。 - 新建订阅：创建新的订阅。 - 导入订阅：选择已创建且确认订阅的订阅用户，导入订阅数据。创建订阅用户详细步骤请参见[创建订阅用户](https://support.huaweicloud.com/usermanual-smn/smn_ug_0045.html)。 | | 订阅终端 | 订阅的终端地址，短信、邮件、HTTP以及HTTPS终端支持批量输入，批量添加时，每个终端地址占一行，最多可输入10个终端。 - 选择"短信"终端，请输入有效手机号码。 输入规则为\[+\]\[国家/地区码\]\[手机号码\]。国内手机号码可省略\[+\]\[国家/地区码\]，直接输入11位有效手机号码，支持使用空格、/和-。 例如： 185xxxx0000 +86185xxxx0000 +86 185 xxxx 0000 - 选择"邮件"终端，请输入有效的邮箱地址。 例如： username@example.com username2@example.com - 选择"HTTP"终端，请输入公网网址。 例如： http://example.com/notification/action - 选择"HTTPS"终端，请输入公网网址。 例如： https://example.com/notification/action - 选择"FunctionGraph（函数）"终端，表示订阅终端是一个函数，单击输入框右侧的"添加终端"选择订阅终端，在"版本"的下拉框中选择可用版本。 - 选择"FunctionGraph（工作流）"终端，表示订阅终端是一组函数编排成的工作流，单击输入框右侧的"添加终端"选择订阅终端。 - 选择"语音通知"终端，请输入有效电话号码。 输入规则为\[+\]\[国家/地区码\]\[手机号码\]。国内手机号码可省略\[+\]\[国家/地区码\]，直接输入11位有效手机号码，支持使用空格、/和-。 例如： 185xxxx0000 +86185xxxx0000 +86 185 xxxx 0000 语音只支持中国大陆部分地区拨打，具体支持地区请参考[语音通话服务区域限制](https://support.huaweicloud.com/VoiceCall_faq/VoiceCall_faq_0000_3.html)。 | | 请求头 | 当"协议"选择"HTTP"或"HTTPS"时，该参数可见。用于选择是否立即配置请求头，若勾选"立即配置"，则需要在下方填写Key值和对应的Value值。最多可添加10个请求头。 Key值应该满足以下条件： - 不区分大小写且不能重复。 - 以x-开头但不能以x-smn开头。 - 只能由数字、英文字母或中划线（-）组成，中划线不能作为结尾且不能连续出现。 | | 可用性检测 | 当"协议"选择"HTTP"或"HTTPS"时，该参数可见。单击"立即检测"，可探测SMN到HTTP/HTTPS终端的实时连通性。 | | 版本 | 当"协议"选择"FunctionGraph（函数）"时，该参数可见。选择已创建的FunctionGraph（函数）的版本。若需要创建新的版本，请参见[版本管理](https://support.huaweicloud.com/usermanual-functiongraph/functiongraph_01_0180.html)。 | | 备注 | 用于输入该订阅的备注信息。 若需要修改订阅备注信息，可在订阅列表中单击待修改备注信息的订阅的备注列的![](https://support.huaweicloud.com/usermanual-smn/zh-cn_image_0000002093045673.png)进行修改。 | 5. （可选）配置订阅筛选策略，用于限定消息发布范围。 订阅筛选策略应用于消息属性。当订阅者设置了筛选策略，且发布消息时设置了消息属性，则在消息发布时会根据订阅筛选策略判断消息是否推送给订阅者。配置样例请参见[订阅筛选策略使用样例](https://support.huaweicloud.com/usermanual-smn/smn_ug_a9005.html)。 订阅筛选策略的格式为JSON格式。样例如下： ``` { "filter_polices": [ { "name": "policy_name", "string_equals": [ "policy_value" ] } ] } ``` 6. 单击"确定"。 新增订阅将显示在页面下方的订阅列表中。 ![](https://support.huaweicloud.com/usermanual-smn/public_sys-resources/note_3.0-zh-cn.png) - 为了防止恶意攻击订阅终端，云平台会对订阅终端进行流控保护，触发流控规则后，消息通知服务不再发送订阅确认消息，具体的保护规则请参见《消息通知服务用户指南》的附录"订阅确认流控说明"部分。 - 消息通知服务不会校验订阅终端是否真实存在。 - 添加订阅后，消息通知服务会向订阅终端发送订阅确认信息，信息中包含订阅确认的链接。订阅确认的链接在48小时内有效，用户需要及时在手机端、邮箱或其他协议终端确认订阅。 - 发送请求订阅消息也会作为发送条数进行计费。 #### 后续操作 订阅添加成功后，您可以根据需求，修改订阅的备注信息和订阅筛选策略。具体操作请参见[修改订阅](https://support.huaweicloud.com/usermanual-smn/smn_ug_0810.html)。