导出 (0) 打印
全部展开

对队列服务资源寻址

更新时间: 2013年11月

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

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

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

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

资源 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 来更新或删除。请注意,此语法只能对更新消息 (REST API)删除消息 (REST API)操作使用,并且需要用 popreceipt 参数进行验证:

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

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

 

组件 支持的资源 说明

list

帐户

枚举资源下的实体。基于帐户返回队列的列表。

metadata

队列

设置或返回队列属性,包括用户定义的元数据。

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

支持的 HTTP 操作

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

另请参阅

显示:
© 2014 Microsoft