欢迎来到天天文库
浏览记录
ID:35885567
大小:232.75 KB
页数:111页
时间:2019-04-22
《阿里云-消息服务-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
此文档下载收益归作者所有