订阅主题

操作场景

要接收发布至主题的消息，您必须向该主题添加订阅者。

添加订阅

登录管理控制台。
在管理控制台左上角单击图标，选择区域和项目。
在页面左上角单击图标，选择“管理与监管” > “消息通知服务 SMN”。
进入消息通知服务页面。
在左侧导航栏，选择“主题管理” > “主题”。
进入主题页面。
在主题列表中，选择您要向其添加订阅者的主题，在右侧“操作”栏单击“添加订阅”。
或者单击“主题名称”，在主题详情页的右上角选择“添加订阅”。

此时将显示“添加订阅”对话框。

图1 添加订阅

在“协议”下拉框中选择您需要的协议，在“订阅终端”输入框中输入对应的订阅终端，填写说明如表1所示。

表1 添加订阅参数说明
参数	说明
主题名称	在弹出的对话框中选择的主题的名称。
协议	在下拉框中选择需要订阅终端支持的协议，提供的选项为“短信”、“邮件”、“HTTP”、“HTTPS”、“FunctionGraph（函数）”、“FunctionGraph（工作流）”、“语音通知”、“钉钉群消息”、“企业微信群消息”、“飞书群消息”。说明：其中，“语音通知”、“钉钉群消息”、“企业微信群消息”、“飞书群消息”当前是公测功能，如果需要使用请提交工单申请开通公测。开通公测后，会导致用户当前token失效，需要重新登录才能继续使用（使用API调用时，需要重新获取token）。企业微信群消息，钉钉群消息，飞书群消息有发送条数限制和接收方系统故障情况，可能会导致消息发送失败。当出现上述原因时，SMN不保证消息成功送达。
添加方式	支持“新建订阅”和“导入订阅”两种方式。新建订阅：创建新的订阅。导入订阅：选择已创建且确认订阅的订阅用户，导入订阅数据。创建订阅用户详细步骤请参见创建订阅用户。说明：该功能当前仅“广州-友好用户”区域支持。
订阅终端	订阅的终端地址，短信、邮件、HTTP以及HTTPS终端支持批量输入，批量添加时，每个终端地址占一行，最多可输入10个终端。选择“短信”终端，请输入有效手机号码。输入规则为[+] [国家码][手机号码]。国内手机号码可省略[+]或[+] [国家码]。例如： +8600000000000 +8600000000001 选择“邮件”终端，请输入有效的邮箱地址。例如： username@example.com username2@example.com 选择“HTTP”终端，请输入公网网址。例如： http://example.com/notification/action 选择“HTTPS”终端，请输入公网网址。例如： https://example.com/notification/action 选择“FunctionGraph（函数）”终端，表示订阅终端是一个函数，单击输入框右侧的选择订阅终端，在“版本”的下拉框中选择可用版本。选择“FunctionGraph（工作流）”终端，表示订阅终端是一组函数编排成的工作流，单击输入框右侧的选择订阅终端。选择“语音通知”终端，请输入有效电话号码。输入规则为[+] [国家码][电话号码]。国内电话号码可省略[+]或[+] [国家码]。语音只支持中国大陆部分地区拨打，具体支持地区请参考语音通话服务区域限制。
请求头	当“协议”选择“HTTP”或“HTTPS”时，该参数可见。用于选择是否立即配置请求头，若勾选“立即配置”，则需要在下方填写Key值和对应的Value值。最多可添加10个请求头。 Key值应该满足以下条件：不区分大小写且不能重复。以x-开头但不能以x-smn开头。只能由数字、英文字母或中划线（-）组成，中划线不能作为结尾且不能连续出现。
可用性检测	当“协议”选择“HTTP”或“HTTPS”时，该参数可见。单击“立即检测”，可探测SMN到HTTP/HTTPS终端的实时连通性。
版本	当“协议”选择“FunctionGraph（函数）”时，该参数可见。选择已创建的FunctionGraph（函数）的版本。若需要创建新的版本，请参见版本管理。
备注	用于输入该订阅的备注信息。

（可选）配置订阅筛选策略，用于限定消息发布范围。订阅筛选策略的默认策略应用于消息属性。当订阅者设置了筛选策略，且发布消息时设置了消息属性，则在消息发布时会根据订阅筛选策略判断消息是否推送给订阅者。
订阅筛选策略的格式为JSON格式。样例如下：
```
{
    "filter_polices": [
        {
            "name": "policy_name",
            "string_equals": [
                "policy_value"
            ]
        }
    ]
}
```
单击“确定”。
新增订阅将显示在页面下方的订阅列表中。
- 为了防止恶意攻击订阅终端，云平台会对订阅终端进行流控保护，触发流控规则后，消息通知服务不再发送订阅确认消息，具体的保护规则请参见《消息通知服务用户指南》的附录“订阅确认流控说明”部分。
- 消息通知服务不会校验订阅终端是否真实存在。
- 添加订阅后，消息通知服务会向订阅终端发送订阅确认信息，信息中包含订阅确认的链接。订阅确认的链接在48小时内有效，用户需要及时在手机端、邮箱或其他协议终端确认订阅。
- 发送请求订阅消息也会作为发送条数进行计费。