轻量消息队列(原 MNS)支持把发布到主题的消息推送到阿里短信。本文介绍如何将消息推送到阿里短信。
前提条件
步骤一:创建主题
在左侧导航栏,选择 。
在顶部菜单栏,选择地域。
在主题列表页面,单击创建主题。
在创建主题面板,配置以下参数,然后单击确定。
名称:主题名称。
消息最大长度:发送到主题的消息体的最大长度。
启用日志功能:是否开启日志管理功能。
页面跳转到目标主题的主题详情页面。
步骤二:创建订阅
当前账号
在左侧导航栏,选择 。
在订阅列表页面,单击创建订阅。
在创建订阅面板中,进行以下配置,然后单击确定。
主题名称:订阅所属的主题名称。
订阅名称:输入订阅名称。
订阅类型:选择阿里短信。
是否跨账号:选择当前账号。
是否固定投递:选择投递方式。
从变量获取:在使用SDK发送消息时,可以设置
DmAttributes
中的phoneNumber
变量,从而动态指定消息推送的手机号码,设置方法请参见带有消息属性的主题推送示例。固定投递:选择固定投递,并输入固定投递的手机号码。
国内短信:无任何前缀的手机号码,例如 1390000****。
国际、中国香港、中国澳门和中国台湾:手机号为国际区号+号码,例如 852000012****。
说明若选择从变量获取方式,如果发送消息时未指定phoneNumber,则会发送失败。
若选择固定投递方式,仍然可以在SDK中通过设置
DmAttributes
中的phoneNumber
变量,动态指定手机号码。SDK变量中配置的手机号码的优先级高于订阅创建时输入的手机号码。
短信签名:输入短信签名名称,在短信服务中申请的短信签名。
短信模板:输入短信模板CODE,在短信服务中申请的短信模板。
服务关联角色:轻量消息队列(原 MNS)使用服务关联角色
AliyunMNSSendSMSRolePolicy
来调用短信推送服务,首次使用时需要单击创建服务关联角色 AliyunMNSSendSMSRolePolicy进行授权。说明首次成功创建服务关联角色后,后续无需再次进行创建。
请勿删除已创建的服务关联角色,否则将导致轻量消息队列(原 MNS)短信推失败。
可选:消息过滤标签:输入标签用于过滤消息。
重试策略:选择重试策略。
退避重试:重试3次,间隔时间为10~20秒之间的一个随机值。
指数衰减重试:重试176次,总计重试时间为1天,间隔时间单位为秒,依次为:2^0,2^1,…,512,512,…,512。
消息格式:选择SIMPLIFIED。
跨账号
在左侧导航栏,选择 。
在订阅列表页面,单击创建订阅。
在创建订阅面板中,进行以下配置,然后单击确定。
主题名称:订阅所属的主题名称。
订阅名称:输入订阅名称。
订阅类型:选择阿里短信。
是否跨账号:选择跨账号,并输入跨账号的阿里云UID。
是否固定投递:选择投递方式。
从变量获取:在使用SDK发送消息时,可以设置
DmAttributes
中的phoneNumber
变量,从而动态指定消息推送的手机号码,设置方法请参见带有消息属性的主题推送示例。固定投递:选择固定投递,并输入固定投递的手机号码。
国内短信:无任何前缀的手机号码,例如 1390000****。
国际、中国香港、中国澳门和中国台湾:手机号为国际区号+号码,例如 852000012****。
说明若选择从变量获取方式,如果发送消息时未指定phoneNumber,则会发送失败。
若选择固定投递方式,仍然可以在SDK中通过设置
DmAttributes
中的phoneNumber
变量,动态指定手机号码。SDK变量中配置的手机号码的优先级高于订阅创建时输入的手机号码。
短信签名:输入短信签名名称,在短信服务中申请的短信签名。
短信模板:输入短信模板CODE,在短信服务中申请的短信模板。
服务关联角色:在文本框中输入跨账号授权的RAM角色ARN,RAM角色授权和ARN的获取请参见跨账号推送授权。
可选:消息过滤标签:输入标签用于过滤消息。
重试策略:选择重试策略。
退避重试:重试3次,间隔时间为10~20秒之间的一个随机值。
指数衰减重试:重试176次,总计重试时间为1天,间隔时间单位为秒,依次为:2^0,2^1,…,512,512,…,512。
消息格式:选择SIMPLIFIED。
步骤三:发布消息
在主题列表页面,找到目标主题,在其右侧操作列单击发布消息。
在快速体验向主题发布消息页面,进行以下配置,然后单击发布消息。
消息内容:输入消息正文。
可选:消息标签:输入标签用于过滤消息。
推送订阅类型:选择阿里短信。
短信模板 ID:输入模板CODE。
短信签名:输入签名名称。
批量短信:选择是否使用批量短信。如果选择使用批量短信,可以将不同的短信内容发送到不同的接收者。
接收者:输入接收者的手机号码和短信模板的键值对。
说明匿名订阅会根据指定的接收者来发送短信。
多个手机号码以半角逗号(,)分隔,最多不超过1000个手机号码。
国内手机号码为11位,国际手机号和中国香港、中国澳门和中国台湾手机号为国际区号加号码。
更多参数说明,请参见SendSms。