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