你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
创建 Azure 存储) (队列
该 Create Queue 操作在存储帐户中创建队列。
请求
可以构造请求， Create Queue 如下所示。 建议使用 HTTPS。 将 myaccount 替换为存储帐户的名称。
| 方法 | 请求 URI | HTTP 版本 |
|---|---|---|
PUT |
https://myaccount.queue.core.windows.net/myqueue |
HTTP/1.1 |
模拟存储服务请求
对模拟存储服务发出请求时，将模拟器主机名和 Azure 队列存储端口指定为 127.0.0.1:10001，后跟模拟的存储帐户名称：
| 方法 | 请求 URI | HTTP 版本 |
|---|---|---|
PUT |
http://127.0.0.1:10001/devstoreaccount1/myqueue |
HTTP/1.1 |
有关详细信息，请参阅使用 Azurite 模拟器进行本地 Azure 存储开发。
URI 参数
可以在请求 URI 上指定其他参数，如下所示。
| 参数 | 说明 |
|---|---|
timeout |
可选。
timeout 参数以秒表示。 有关详细信息，请参阅 为队列服务操作设置超时。 |
请求标头
下表描述了必需的和可选的请求标头：
| 请求标头 | 说明 |
|---|---|
Authorization |
必需。 指定授权方案、帐户名称和签名。 有关详细信息，请参阅授权对 Azure 存储的请求。 |
Date 或 x-ms-date |
必需。 指定请求的协调世界时 (UTC)。 有关详细信息，请参阅授权对 Azure 存储的请求。 |
x-ms-version |
可选。 指定用于此请求的操作的版本。 有关详细信息，请参阅 Azure 存储服务的版本控制。 |
x-ms-meta-name:value |
可选。 作为元数据与队列关联的名称-值对。 注意：从版本 2009-09-19 开始，元数据名称必须遵守 C# 标识符的命名规则。 |
x-ms-client-request-id |
可选。 提供客户端生成的不透明值，其中包含 1-kiB (KiB) 配置日志记录时记录在日志中的字符限制。 强烈建议使用此标头将客户端活动与服务器接收的请求相关联。 有关详细信息，请参阅 监视 Azure 队列存储。 |
请求正文
无。
响应
响应包括 HTTP 状态代码和一组响应标头。
状态代码
此操作成功后返回状态代码 201（已创建）。
有关状态代码的信息，请参阅 状态和错误代码。
响应头
此操作的响应包括下表中所述的标头。 响应可能还包括其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范。
| 响应标头 | 说明 |
|---|---|
ms-request-id |
唯一标识发出的请求，你可以使用它对请求进行故障排除。 有关详细信息，请参阅 API 操作疑难解答。 |
x-ms-version |
指示用于执行请求的 Azure 队列存储版本。 针对 2009-09-19 和更高版本发出的请求将返回此标头。 |
Date |
由服务生成的 UTC 日期/时间值，该值指示启动响应的时间。 |
x-ms-client-request-id |
可用于对请求和相应响应进行故障排除。 如果请求中存在此标头的值，并且该值包含不超过 1024 个可见 ASCII 字符，则此标头的值等于该标头的值 x-ms-client-request-id 。
x-ms-client-request-id如果请求中不存在标头，则它不会出现在响应中。 |
示例响应
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: Fri, 16 Sep 2011 01:20:22 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
授权
只有帐户所有者可以调用此操作。
注解
创建队列时，可以在队列上将用户定义的元数据指定为名称/值对。
如果已存在具有指定名称的队列，Azure 队列存储会检查与现有队列关联的元数据。 如果现有元数据与请求中指定的 Create Queue 元数据相同，则返回状态代码 204 (“无内容) ”。 如果现有元数据与请求提供的 Create Queue 元数据不匹配，则操作将失败，并返回状态代码 409 (冲突) 。 客户端可以利用此行为来避免对检查进行额外调用，以查看是否已存在命名队列。
有关有效队列名称的指导，请参阅 命名队列和元数据。 如果指定的队列名称不是有效名称，则 Create Queue 操作将返回状态代码 400 (错误请求) 以及其他错误信息，如以下示例所示：
HTTP/1.1 400 One of the request inputs is out of range.
Connection: Keep-Alive
Content-Length: 226
Via: 1.1 TK5-PRXY-22
Date: Wed, 02 May 2012 17:47:54 GMT
Content-Type: application/xml
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f
x-ms-version: 2011-08-18
<?xml version="1.0" encoding="utf-8"?>
<Error>
<Code>OutOfRangeInput</Code>
<Message>One of the request inputs is out of range.
RequestId:fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f
Time:2012-05-02T17:47:55.4334169Z</Message>
</Error>