添加订阅

操作场景

订阅是您将订阅者注册到主题的操作。要接收发布至主题的消息，您必须订阅一个订阅终端到该主题。终端节点可以是手机号码、邮箱地址、函数或HTTP(S)终端。为终端节点订阅主题且确认订阅后，终端节点能够接收到向该主题发布的所有消息。

您可以拥有多个主题，每个主题有多个订阅者。当您需要向创建的主题添加订阅者操作，或者向已获取授权的主题添加订阅者时，可参考本章节。

添加订阅

1. 登录管理控制台。
2. 在管理控制台左上角单击图标，选择区域和项目。
3. 在页面左上角单击图标，选择“管理与监管” > “消息通知服务 SMN”。

   进入消息通知服务页面。

4. 在左侧导航栏，选择“主题管理” >“订阅”。
5. 在订阅页面。单击“添加订阅”，开始添加消息订阅。

   此时将显示“添加订阅”页面。

   图1 添加订阅
   
6. 向指定主题添加订阅。
   1. 单击“主题名称”输入框右侧的“选择主题”，在弹出的选择主题对话框中选择主题。
   2. 在“协议”下拉框中选择订阅终端支持的协议，在“订阅终端”输入框中输入对应的订阅终端，填写说明如表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（函数）的版本。若需要创建新的版本，请参见版本管理。
      备注	用于输入该订阅的备注信息。

   3. （可选）配置订阅筛选策略，用于限定消息发布范围。订阅筛选策略的默认策略应用于消息属性。当订阅者设置了筛选策略，且发布消息时设置了消息属性，则在消息发布时会根据订阅筛选策略判断消息是否推送给订阅者。
      订阅筛选策略的格式为JSON格式。样例如下：

      {
          "filter_polices": [
              {
                  "name": "policy_name",
                  "string_equals": [
                      "policy_value"
                  ]
              }
          ]
      }

7. 单击“确定”。

   新增订阅将显示在页面下方的订阅列表中。

   

   • 为了防止恶意攻击订阅终端，云平台会对订阅终端进行流控保护，触发流控规则后，消息通知服务不再发送订阅确认消息，具体的保护规则请参见《消息通知服务用户指南》的附录“订阅确认流控说明”部分。
   • 消息通知服务不会校验订阅终端是否真实存在。
   • 添加订阅后，消息通知服务会向订阅终端发送订阅确认信息，信息中包含订阅确认的链接。订阅确认的链接在48小时内有效，用户需要及时在手机端、邮箱或其他协议终端确认订阅。
   • 发送请求订阅消息也会作为发送条数进行计费。