PDF《消息服务 MNS》

消息服务 MNS API 参考

9 - - - - - - - - - - - - - - AccountId:表示主题所有者的帐号 ID,实际调用 MNS 的API 时请替换成实际的帐号 ID;

TopicName:表示主题的名称,实际调用 MNS 的API 时请替换成实际的主题名称;

SubscriptionName:表示Subscription的名称,实际调用 MNS 的API 时请替换成实际 Subscription 的名称.同一个订阅者订阅相同的主题时,SubscriptionName 不能重复. Endpoint Endpoint 是用户订阅主题时,指定接收消息的终端地址;

当有消息发布到主题时,MNS 会主动将消息推送到对应的 Endpoint;

多个 Subscription 可以指定同一个 Endpoint;

HttpEndpoint http 格式的Endpoint;

格式:http://$company.com[/uri],支持多级uri;

限制:Endpoint的uri不能以 mns-reserverd- 开头;

MNS 将发送 http 请求到指定的Endpoint,用户在Endpoint端处理请求即可;

QueueEndpoint 以队列的资源描述作为Endpoint;

格式:acs:mns:{REGION}:{AccountID}:queues/{QueueName} ;

限制:只支持推送到 Topic 同Region同账号的队列中;

MNS 直接将消息写入到指定的队列中,用户通过receive message接口读取消息,具体使用方式请参 考详情;

MailEndpoint 以Mail名称作为Endpoint;

格式:mail:directmail:{MailAddress};

MNS 将以mail的形式将消息推送到指定的邮箱中,具体使用方式请参考详情;

NotifyStrategy 消息服务 MNS API 参考

10 - - - NotifyStrategy 描述了 MNS 向Enpoint 推送消息出现错误时的重试策略.MNS 支持以下几种重试策略,用 户订阅主题时,可以指定一种重试策略: NotifyContentFormat NotifyContenFormat 用于指定 MNS 向Endpoint 推送消息时,消息内容的格式. XML 消息体为XML格式,包含消息正文和消息属性;

HttpEndpoint和QueueEndpoint支持该格式;

消息示例: JSON 策略 描述 参数 退避重试策略 重试

3 次,每次重试的间隔时 间是 10秒到20秒 之间的随机 值BACKOFF_RETRY 指数衰减重试 重试

176 次,每次重试的间隔 时间指数递增至 512秒,总计重 试时间为1天;

每次重试的具体 间隔为:1, 2, 4, 8, 16, 32, 64, 128, 256, 512,

512 ...

512 秒 (共167个512) EXPONENTIAL_DECAY_RETRY TopicOwner TopicName Subscriber SubscriptionName 6CC4D900CA59A2CD-1-15180534A8F-200000002 {1: a , 2: b } F1E92841751D795AB325861034B5CB55 important

1449556920975 消息服务 MNS API 参考

11 - - - - - - 消息体为JSON格式,包含消息正文和消息属性;

HttpEndpoint和QueueEndpoint支持该格式;

消息示例: SIMPLIFIED 消息体即用户发布的消息,不包含任何属性信息;

HttpEndpoint、QueueEndpoint、MailEndpoint均支持该格式;

消息体示例: 调用方式 请求结构 服务地址 MNS 服务在多个地域部署,都分别提供了公网访问地址和阿里云内网(ECS 经典网络 / VPC)访问地址 .如表所示: { TopicOwner : TopicOwner , TopicName : TopicName , Subscriber : Subscriber , SubscriptionName : SubscriptionName , MessageId : 6CC4D900CA59A2CD-1-15180534A8F-200000002 , Message : xxxxx , MessageMD5 : F1E92841751D795AB325861034B5CB55 , MessageTag : important , PublishTime :

1449556920975 } {1: a , 2: b } 区域 公网 阿里云内网(ECS 经典网络 / 消息服务 MNS API 参考

12 AccountID 是阿里云注册用户的帐号 ID,在阿里云官网可以查看.为了帮助保护用户的数据安全,MNS在公 网提供了Https的接口,只需要把公网访问地址的 http:// 换成 htt........