阿里云-消息服务-API手册.pdf

消息服务 API使用手册 消息服务/API使用手册 API使用手册 简介 消息服务简介 - MNS 是一种高效、可靠、安全、便捷、可弹性扩展的分布式消息服务。 - 能够帮助应用开发者在他们应用的分布式组件上自由的传递数据，构建松耦合系统。 - MNS 提供两种功能：队列模型（Queue）和主题模型（Topic）。其中队列模型支持一对一发送和接 收消息，已经商用；主题模型提供pub/sub模型，支持一对多订阅和通知消息，公测中。 队列模型 - 队列模型保证消息至少会被消费一次， 支持多个生产者和消费者并发操作同一个消息队列。 - 消费消息时尽量做到先进先出，正是因为分布式消息队列的一些特性并不能保证你能按照消息的发送 顺序消费消息，如果你的业务必需先进先出， 建议在消息中加入序号信息以便消费消息后进行重新排 序。 主题模型 - 主题模型支持服务端主动将消息推送给用户指定的回调地址（Endpoint），消除用户程序不必要的轮 询和资源消耗。 - 主题模型保证通知消息按照指定的策略推送给用户，支持多个消息发布者并发操作同一个主题。 - 主题模式支持一对多广播消息，一条通知消息可以同时被多个订阅者接收和消费。 1 消息服务/API使用手册 基本概念 Account Account 是阿里云的注册用户，在 MNS 中以阿里云注册帐号的 ID 表示。 队列模型 队列所有者 开通 MNS 服务的 Account 通过 CreateQueue 接口创建出一个消息队列，这个 Account 就是这个队列 的所有者，队列所有者拥有此队列的所有操作权限。队列所有者对应的Account ID在阿里云官网可以查看 。 生产者、消费者 生产者，向 MNS 的消息队列发送消息的角色。 2 消息服务/API使用手册 消费者，从 MNS 的消息队列获取消息的角色。 主题模型 主题所有者 开通 MNS 服务的 Account 通过 CreateTopic 接口创建出一个主题，这个 Account 就是该主题的所有者 ，主题所有者拥有该主题的所有操作权限。 发布者、订阅者 发布者，向 MNS 的主题发布消息的角色。 订阅者，从 MNS 的主题接收消息的角色。 Queue 队列是消息存储的目的地，队列可以分成普通队列和延时队列两类。 如果发送消息时不指定消息延时参数，被发送到普通队列的消息立刻可以被消费，而发送到延时队列需要经过 设定的延时时间后才能被消费。 队列属性 DelaySeconds - 消息延迟时间，单位为秒； - 取值范围：0 ~ 604800秒(7天)； - 当该属性大于0时，发送到队列的所有消息是延迟消息，经过该属性指定的秒数后变为可消费消息； - 如果发送消息请求指定了DelaySeconds，以请求指定的DelaySeconds为准；