你当前正在访问 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。