建立佇列 (Azure 儲存體)

作業會 Create Queue 在儲存體帳戶中建立佇列。

要求

Create Queue 要求的建構如下。 建議使用 HTTPS。 以您的儲存體帳戶名稱取代 我的帳戶

方法 要求 URI HTTP 版本
PUT https://myaccount.queue.core.windows.net/myqueue HTTP/1.1

模擬儲存體服務 URI

對模擬儲存體服務提出要求時,請將模擬器主機名稱和佇列服務通訊埠指定為 127.0.0.1:10001,後面接著模擬儲存體帳戶名稱:

方法 要求 URI HTTP 版本
PUT http://127.0.0.1:10001/devstoreaccount1/myqueue HTTP/1.1

URI 參數

您可以在要求的 URI 中指定下列其他參數。

參數 描述
timeout 選擇性。 timeout 參數以秒為單位。 如需詳細資訊,請參閱 設定佇列服務作業的超時

要求標頭

下表描述必要的和選用的要求標頭。

要求標頭 描述
Authorization 必要。 指定授權配置、帳戶名稱和簽章。 如需詳細資訊,請參閱授權 Azure 儲存體的要求
Datex-ms-date 必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊,請參閱授權 Azure 儲存體的要求
x-ms-version 選擇性。 指定用於這個要求的作業版本。 如需詳細資訊,請參閱Azure 儲存體服務的版本控制
x-ms-meta-name:value 選擇性。 做為中繼資料並與佇列相關聯的名稱/值組。

請注意,從2009-09-19 版開始,中繼資料名稱必須遵守 c # 識別碼的命名規則。
x-ms-client-request-id 選擇性。 提供用戶端產生的不透明值,具有1個 KiB 字元限制,當啟用儲存體分析記錄時,記錄在分析記錄中。 強烈建議使用此標頭來將用戶端活動與伺服器接收的要求相互關聯。 如需詳細資訊,請參閱關於儲存體分析記錄Azure 記錄:使用記錄檔追蹤儲存體要求

要求本文

無。

回應

回應包括 HTTP 狀態碼和一組回應標頭。

狀態碼

成功的作業會傳回狀態碼「201 (已建立)」。

如需狀態碼的相關資訊,請參閱 狀態和錯誤碼

回應標頭

這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格

回應標頭 描述
ms-request-id 此標頭可唯一識別提出的要求,而且可用來進行要求的疑難排解。 如需詳細資訊,請參閱 疑難排解 API 作業
x-ms-version 指出用於執行要求的佇列服務版本。 對 2009-09-19 及更新版本提出要求會傳回此標頭。
Date 服務產生的 UTC 日期/時間值,可指出啟動回應的時間。
x-ms-client-request-id 此標頭可用於疑難排解要求和對應的回應。 x-ms-client-request-id如果要求中有標頭的值,且值最多1024個可見的 ASCII 字元,則此標頭的值會等於標頭的值。 如果 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  

授權

只有帳戶擁有者可呼叫這項作業。

備註

您可以在建立佇列時,於佇列中指定使用者定義的中繼資料做為名稱/值組。

如果指定名稱的佇列已經存在,佇列服務會檢查是否有與現有佇列相關聯的中繼資料。 如果現有的中繼資料與 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>  

另請參閱

佇列服務錯誤碼
授權 Azure 儲存體的要求
狀態和錯誤碼