阿里云消息服务(MNS)API文档

《阿里云消息服务(MNS)API文档》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、消息服务API使用手册消息服务/API使用手册API使用手册简介简介消息通知服务简介●MNS是一种高效、可靠、安全、便捷、可弹性扩展的分布式消息通知服务。●能够帮助应用开发者在他们应用的分布式组件上自由的传递数据，构建松耦合系统。●保证消息至少会被消费一次，支持多个生产者和消费者并发操作同一个消息队列。●消费消息时尽量做到先进先出，正是因为分布式消息队列的一些特性并不能保证你能按照消息的发送顺序消费消息，如果你的业务必需先进先出，建议在消息中加入序号信息以便消费消息后进行重新排序。基本概念AccountAccoun

2、tAccount是阿里云的注册用户，在MNS中以阿里云注册帐号的ID表示（形式为的16位数字串）。队列所有者开通MNS服务的Account通过CreateQueue接口创建出一个消息队列，这个Account就是这个消息队列的所有者，消息队列所有者拥有此消息队列的所有操作权限。消息队列所有者对应的AccountID在阿里云官网的用户中心可以查看。生产者、消费者生产者，向MNS的消息队列发送消息的角色。消费者，从MNS的消息队列获取消息的角色。QueueQueue1消息服务/API使用手册消息队列是消息存储的目的地，消

3、息队列可以分成普通消息队列和延时消息队列两类。如果发送消息时不指定消息延时参数，被发送到普通消息队列的消息立刻可以被消费，而发送到延时消息队列需要经过设定的延时时间后才能被消费。QueueURL是标识Queue的URL，格式如下：http://$AccountId.mns..aliyuncs.com/queues/$QueueName●mns..aliyuncs.com：MNS访问域名，Region是MNS部署的区域，用户可以根据应用需要选择不同的地域.●AccountId：表示消息

4、队列所有者的帐号ID，实际调用MNS的API时请替换成实际的帐号ID.●QueueName：表示消息队列的名称，MNS使用者在实际调用API的过程中替换成实际消息队列名称，同一个AccountId在同Region中的消息队列名不能重名.MessageMessage消息包含数据和属性，消息可以分成普通消息和延时消息，在一个消息队列中能唯一标识一个消息的有MessageId和ReceiptHandle两种。普通消息、延时消息消息主要分成普通消息和延时消息，普通消息是指被发送到消息队列马上可以被取到的消息；延时消息是指消

5、息发送到队列后需要经过一定的时间后才能被取到的消息，延时时长由DelaySeconds属性定（请参考SendMessage相关属性定）。普通消息被发送到延时消息队列也具有延时特性（请参考Queue相关章节）。MessageIdMessageId主要用来标识在消息队列中的一个消息，在一个消息队列中每个消息都有唯一的MessageId，但在不同的消息队列之中并不唯一。当消息发送到MNS消息队列，MNS会生成一个MessageId，此ID一旦产生就不会改变，并在请求响应中返回，用户主要可以使用此MessageId来做数据

6、校对，但是删除消息必须使用ReceiptHandle。ReceiptHandleReceiptHandle是由MNS根据当时获取消息的行为产生的临时性消息标识，这一点不同于MessageId。当要删除已消费的消息或者改变其VisiblityTimeout属性值，需要用ReceiptHandle指定已消费过的消息。ReceiptHandle只能被使用一次，如果ReceiptHandle标识的消息状态改变其就会失效，消费者只有通过获取消息后重新获取ReceiptHandle才能进行上述操作。MessageStatus2

7、消息服务/API使用手册普通消息被发送到普通消息队列时，初始状态是Active，当其被取走后在VisibilityTimeout的时间内状态为Inactive，若超过VisibilityTimeout时间后消息还未被删除，消息会重新变成Active状态；如果在VisibilityTimeout时间内被删除，消息状态为Deleted。普通消息发送到延时消息队列时，消息初始状态Delayed，经过延时消息队列的DelaySeconds属性值设定的时间后，消息状态变成Active。延时消息发送到消息队列（普通消息队列或者

8、延时消息队列），消息的初始状态为Delayed，经过消息的DelaySeconds属性指定的时间后消息状态变成Active。消息的最长存活时间由创建消息队列时指定的MessageRetentionPeriod属性值决定，超过此时间后消息状态会变成Expired，将被垃圾回收器回收。消费者只能取到处于Active状态的消息。调用方式请求结构请求结构服务地址MN