阿里云-消息服务-API手册-D

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

1、消息服务API使用手册消息服务/API使用手册API使用手册简介消息服务简介-MNS是一种高效、可靠、安全、便捷、可弹性扩展的分布式消息服务。-能够帮助应用开发者在他们应用的分布式组件上自由的传递数据，构建松耦合系统。-MNS提供两种功能：队列模型（Queue）和主题模型（Topic）。其中队列模型支持一对一发送和接收消息，已经商用；主题模型提供pub/sub模型，支持一对多订阅和通知消息，公测中。队列模型-队列模型保证消息至少会被消费一次，支持多个生产者和消费者并发操作同一个消息队列。-消费消息时尽量做到先进先出，正是因为分布式消息队列的一

2、些特性并不能保证你能按照消息的发送顺序消费消息，如果你的业务必需先进先出，建议在消息中加入序号信息以便消费消息后进行重新排序。主题模型-主题模型支持服务端主动将消息推送给用户指定的回调地址（Endpoint），消除用户程序不必要的轮询和资源消耗。-主题模型保证通知消息按照指定的策略推送给用户，支持多个消息发布者并发操作同一个主题。-主题模式支持一对多广播消息，一条通知消息可以同时被多个订阅者接收和消费。109消息服务/API使用手册基本概念AccountAccount是阿里云的注册用户，在MNS中以阿里云注册帐号的ID表示。队列模型队列所有者

3、开通MNS服务的Account通过CreateQueue接口创建出一个消息队列，这个Account就是这个队列的所有者，队列所有者拥有此队列的所有操作权限。队列所有者对应的AccountID在阿里云官网可以查看。生产者、消费者生产者，向MNS的消息队列发送消息的角色。109消息服务/API使用手册消费者，从MNS的消息队列获取消息的角色。主题模型主题所有者开通MNS服务的Account通过CreateTopic接口创建出一个主题，这个Account就是该主题的所有者，主题所有者拥有该主题的所有操作权限。发布者、订阅者发布者，向MNS的主题发布

4、消息的角色。订阅者，从MNS的主题接收消息的角色。Queue队列是消息存储的目的地，队列可以分成普通队列和延时队列两类。如果发送消息时不指定消息延时参数，被发送到普通队列的消息立刻可以被消费，而发送到延时队列需要经过设定的延时时间后才能被消费。队列属性DelaySeconds-消息延迟时间，单位为秒；-取值范围：0~604800秒(7天)；-当该属性大于0时，发送到队列的所有消息是延迟消息，经过该属性指定的秒数后变为可消费消息；-如果发送消息请求指定了DelaySeconds，以请求指定的DelaySeconds为准；MaximumMessa

5、geSize-消息体最大长度，单位为Byte；-取值范围：1024~65536Byte(64KB)；-该属性用于限制发送到队列的消息体最大长度，超过该长度发送消息失败；MessageRetentionPeriod109消息服务/API使用手册-消息最长保留时间，单位为秒；-取值范围：60~1296000秒(15天)；-发送到队列的消息最长保留该时长，超过指定时间，无论消息是否被消费都将被删除；VisibilityTimeout-消息被receive后的隐藏时长，单位为秒；-取值范围：1~43200秒(12小时)；-消息被receive后，在该

6、属性指定的这段时间内消息处于隐藏状态，在这段时间内，可以删除消息或者修改消息隐藏时长；超过这段时间，消息可以再次被receive；PollingWaitSeconds-(batch)receivemessage请求最长等待时间，单位为秒；-取值范围：0~30秒；-当队列中没有消息时，(batch)receivemessage请求将挂在MNS服务器端；在该属性指定的时间范围内，如果有消息发送到队列中，立即返回消息给用户；如果超过该时间，仍然没有消息，返回MessageNotExist；-如果(batch)receivemessage请求指定了w

7、aitseconds，以请求指定的时间为准；LoggingEnabled-是否开启日志管理功能；-取值范围：True/False；-当该属性为True时，MNS将收集队列的消息操作日志推送到指定的地方，日志管理请参考详情；CreateTime-队列创建时间，从1970-1-100:00:00到现在的秒值；LastModifyTime-修改队列属性信息最近时间，从1970-1-100:00:00到现在的秒值；ActiveMessages-队列中处于Active状态的消息总数，为近似值；InactiveMessages109消息服务/API使用手

8、册-队列中处于Inactive状态的消息总数，为近似值；DelayMessages-队列中处于Delayed状态的消息总数，为近似值；QueueURL-格式：htt