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

订阅主题

操作场景

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

添加订阅

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

    进入消息通知服务页面。

  4. 在左侧导航栏,选择“主题管理” > “主题”。

    进入主题页面。

  5. 在主题列表中,选择您要向其添加订阅者的主题,在右侧“操作”栏单击“添加订阅”。

    或者单击“主题名称”,在主题详情页的右上角选择“添加订阅”。

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

    图1 添加订阅
  6. 在“协议”下拉框中选择您需要的协议,在“订阅终端”输入框中输入对应的订阅终端,填写说明如表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(函数)的版本。若需要创建新的版本,请参见版本管理

    备注

    用于输入该订阅的备注信息。

  7. (可选)配置订阅筛选策略,用于限定消息发布范围。订阅筛选策略的默认策略应用于消息属性。当订阅者设置了筛选策略,且发布消息时设置了消息属性,则在消息发布时会根据订阅筛选策略判断消息是否推送给订阅者。
    订阅筛选策略的格式为JSON格式。样例如下:
    {
        "filter_polices": [
            {
                "name": "policy_name",
                "string_equals": [
                    "policy_value"
                ]
            }
        ]
    }
  8. 单击“确定”。

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

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

相关文档