Subscription描述一个订阅关系,包括被订阅的主题和接收消息的Endpoint;订阅者通过Subscribe接口创建订阅,MNS根据订阅的描述给用户推送消息,推送的起点是订阅时Topic中最新的消息;订阅创建成功后,MNS会向指定的Endpoint推送消息。如果Endpoint不可用,MNS会按照指定的重试策略进行重试,重试失败后,会丢弃消息。

SubscriptionURL
  • 标识Subscription的URL格式:http://$AccountId.mns.<Region>.aliyuncs.com/topic/$TopicName/subscriptions/$SubscriptionName
  • mns.<Region>.aliyuncs.com:MNS访问域名,Region是MNS部署的地域,您可以根据应用需要选择不同的区域,具体各地域的访问域名可以在控制台通过获取Endpoint操作查看;

  • AccountId:表示主题所有者的账号ID,实际调用MNS的API时请替换成实际的账号ID;
  • TopicName:表示主题的名称,实际调用MNS的API时请替换成实际的主题名称;
  • SubscriptionName:表示Subscription的名称,实际调用MNS的API时请替换成实际Subscription的名称。同一个订阅者订阅相同的主题时,SubscriptionName不能重复。

订阅属性

Endpoint
  • 接收消息的Endpoint;
  • 支持类型:HttpEndpoint、QueueEndpoint和MailEndpoint。
FilterTag
  • 过滤消息的标签;
  • 类型:字符串;
  • 指定了该属性后,MNS仅推送消息标签与该属性一致的消息到对应的Endpoint。
NotifyStrategy
  • 消息推送出现错误时的重试策略;
  • 取值范围:BACKOFF_RETRY/EXPONENTIAL_DECAY_RETRY;
  • 当推送消息失败时,MNS将按照该属性指定的重试策略进行重试,超过重试策略的次数后,MNS将丢弃这条消息,继续推送下一条消息;
  • 具体的重试策略请参见NotifyStrategy
NotifyContentFormat
  • 推送给Endpoint的消息格式;
  • 取值范围:XML/SIMPLIFIED;
  • 具体推送消息的格式请参见NotifyContentFormat
CreateTime
订阅的创建时间,从1970-1-1 00:00:00到现在的秒值。
LastModifyTime
修改订阅属性信息的最近时间,从1970-1-1 00:00:00到现在的秒值。