更新时间:2024-09-12 GMT+08:00
分享

添加订阅

操作场景

订阅是您将订阅者注册到主题的操作。要接收发布至主题的消息,您必须订阅一个订阅终端到该主题。终端节点可以是手机号码、邮箱地址、函数或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小时内有效,用户需要及时在手机端、邮箱或其他协议终端确认订阅。
    • 发送请求订阅消息也会作为发送条数进行计费。

相关文档