Subscription

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)部署的地域,您可以根据应用需要选择不同的地域,具体各地域的访问域名,请参见功能开服和接入点

    • AccountId:主题所有者的账号ID。

      实际调用轻量消息队列(原 MNS)的API时请替换成实际的账号ID。

    • TopicName:主题的名称。

      实际调用轻量消息队列(原 MNS)的API时请替换成实际的主题名称。

    • SubscriptionName:Subscription的名称。

      实际调用轻量消息队列(原 MNS)的API时请替换成实际Subscription的名称。同一个订阅者订阅相同的主题时,SubscriptionName不能重复。

订阅属性

  • Endpoint

    • 接收消息的Endpoint。

    • 支持类型: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到现在的秒值。