阅读58 返回首页    go 阿里云 go 技术社区[云栖]

Subscription__基本概念_API使用手册_消息服务-阿里云

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

订阅属性

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

SubscriptionURL

  • 标识 Subscription 的 URL 格式：https://$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 不能重复。

最后更新：2016-11-23 16:03:57

  上一篇：go TopicMessage__基本概念_API使用手册_消息服务-阿里云
  下一篇：go Endpoint__基本概念_API使用手册_消息服务-阿里云