你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

寻址队列服务资源

队列服务通过 REST API 公开以下资源:

  • “帐户”。 存储帐户是存储系统中的一个唯一标识的实体。 帐户是队列服务的父级命名空间。 所有队列都与一个帐户关联。

  • 队列。 队列存储客户端应用程序或服务检索的消息。

  • 消息。 消息是 UTF-8 编码的文本,可以是 XML 元素的值。 消息的大小可以为 64 KiB。

资源 URI 语法

每个资源均具有一个对应的基本 URI,它指的是资源本身。

对于存储帐户,队列操作的基本 URI 仅包括帐户的名称:

https://myaccount.queue.core.windows.net  

对于队列,基本 URI 包括帐户名称和队列名称:

https://myaccount.queue.core.windows.net/myqueue  

对于队列中的消息,基本 URI 包括帐户名称、队列名称和该队列中的消息集:

https://myaccount.queue.core.windows.net/myqueue/messages  

单条消息可通过引用消息 ID 来更新或删除。 请注意,此语法仅适用于“更新消息”和“删除消息”操作,并且需要参数popreceipt进行验证:

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value  

每个资源也可以具有组件,组件表示为基本 URI 中查询字符串的一部分。 查询字符串的语法是 ?comp=<component_name>。 目前,队列资源可以使用以下资源组件作为 URI 中的参数。

组件 支持的资源 说明
list 帐户 枚举资源下的实体。 基于帐户返回队列的列表。
metadata 队列 设置或返回队列属性,包括用户定义的元数据。

请注意,所有查询参数值必须采用 URL 编码,然后再将这些值发送到 Azure 存储服务。

支持的 HTTP 操作

每个资源支持基于 HTTP 动词 GET、PUT、HEAD 和 DELETE 的操作。 每个操作的参考页上显示了该操作的动词、语法和支持的 HTTP 版本。 有关操作参考页的完整列表,请参阅 队列服务 REST API

另请参阅

命名队列和元数据
队列上的操作
对消息的操作
队列服务 REST API