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