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。
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到现在的秒值。