邮箱

轻量消息队列(原 MNS)支持把发布到主题的消息推送到邮箱。本文介绍如何将消息推送至邮箱。

前提条件

步骤一:创建主题

  1. 登录轻量消息队列(原 MNS)控制台

  2. 在左侧导航栏,选择主题模型 > 主题列表

  3. 在顶部菜单栏,选择地域。

  4. 主题列表页面,单击创建主题

  5. 创建主题面板,配置以下参数,然后单击确定

    • 名称:主题名称。

    • 消息最大长度:发送到主题的消息体的最大长度。

    • 启用日志功能:是否开启日志管理功能。

    页面跳转到目标主题的主题详情页面。

步骤二:创建订阅

当前账号

  1. 在左侧导航栏,选择主题模型 > 订阅列表

  2. 订阅列表页面,单击创建订阅

  3. 创建订阅面板中,进行以下配置,然后单击确定

    • 主题名称:订阅所属的主题名称。

    • 订阅名称:输入订阅名称。

    • 推送类型:选择邮箱

    • 是否跨账号:选择当前账号

    • 是否固定投递:选择投递方式。

      • 从变量获取:在使用SDK发送消息时,可以设置DmAttributes中的mailAddress变量,从而动态指定消息推送的邮箱地址,设置方法请参见带有消息属性的主题推送示例

      • 固定投递:选择固定投递,并输入固定投递的邮箱地址。

      说明
      • 若选择从变量获取方式,如果发送消息时未指定mailAddress,则会发送失败。

      • 若选择固定投递方式,仍然可以在SDK中通过设置DmAttributes中的mailAddress变量,动态指定邮箱地址。SDK变量中配置的邮箱地址的优先级高于订阅创建时输入的邮箱地址。

    • 发信地址:输入发信地址。

    • 邮件主题:输入邮件主题。

      说明

      可以在SDK中通过设置DmAttributes中的subject变量,动态指定邮箱主题。

    • 服务关联角色轻量消息队列(原 MNS)使用服务关联角色AliyunMNSPushMailRole来调用邮件推送服务,首次使用时需要单击创建服务关联角色 AliyunMNSPushMailRole进行授权。

      说明
      • 首次成功创建服务关联角色后,后续无需再次进行创建。

      • 请勿删除已创建的服务关联角色,否则将导致轻量消息队列(原 MNS)邮件推送失败。

    • 可选:消息过滤标签:输入标签用于过滤消息。

    • 重试策略:选择重试策略。

      • 退避重试:重试3次,间隔时间为10~20秒之间的一个随机值。

      • 指数衰减重试:重试176次,总计重试时间为1天,间隔时间单位为秒,依次为:2^0,2^1,…,512,512,…,512。

    • 消息推送格式:选择SIMPLIFIED

跨账号

  1. 在左侧导航栏,选择主题模型 > 订阅列表

  2. 订阅列表页面,单击创建订阅

  3. 创建订阅面板中,进行以下配置,然后单击确定

    • 主题名称:订阅所属的主题名称。

    • 订阅名称:输入订阅名称。

    • 推送类型:选择邮箱

    • 是否跨账号:选择跨账号,并输入跨账号的阿里云UID。

    • 是否固定投递:选择投递方式。

      • 从变量获取:在使用SDK发送消息时,可以设置DmAttributes中的mailAddress变量,从而动态指定消息推送的邮箱地址,设置方法请参见带有消息属性的主题推送示例

      • 固定投递:选择固定投递,并输入固定投递的邮箱地址。

      说明
      • 若选择从变量获取方式,如果发送消息时未指定mailAddress,则会发送失败。

      • 若选择固定投递方式,仍然可以在SDK中通过设置DmAttributes中的mailAddress变量,动态指定邮箱地址。SDK变量中配置的邮箱地址的优先级高于订阅创建时输入的邮箱地址。

    • 发信地址:输入发信地址。

    • 邮件主题:输入邮件主题。

      说明

      可以在SDK中通过设置DmAttributes中的subject变量,动态指定邮箱主题。

    • 服务关联角色:在文本框中输入跨账号授权的RAM角色ARN,RAM角色授权和ARN的获取请参见跨账号推送授权

    • 可选:消息过滤标签:输入标签用于过滤消息。

    • 重试策略:选择重试策略。

      • 退避重试:重试3次,间隔时间为10~20秒之间的一个随机值。

      • 指数衰减重试:重试176次,总计重试时间为1天,间隔时间单位为秒,依次为:2^0,2^1,…,512,512,…,512。

    • 消息推送格式:选择SIMPLIFIED

步骤三:发布消息

  1. 主题列表页面,找到目标主题,在其右侧操作列,单击详情

  2. 主题详情页面,单击发布消息

  3. 快速体验向主题发布消息页面,进行以下配置,然后单击发布消息

    • 消息内容:输入消息正文。

    • (可选)消息标签:输入标签用于过滤消息。

    • 推送订阅类型:选择邮箱

      • 邮件主题:输入邮件主题。

      • 发信地址:输入发信地址。

      • 回信地址:选择是否启用邮件推送控制台配置的回信地址。

      • 地址类型:选择发送邮件的地址类型。

        • 随机账号邮件推送(Direct Mail)提供的系统生成的临时或随机的发件人账号。通常用于一次性或匿名的邮件发送,以保护您的个人信息或者在大量发送邮件时避免邮件被标记为垃圾邮件。

        • 发信地址:在邮件推送(Direct Mail)控制台中配置的发件人邮箱地址。用于发送邮件的正式邮箱地址。

      • HTML正文:选择邮件内容是否为HTML格式。