刪除佇列 (Azure 儲存體)

Delete Queue 作業可永久刪除指定的佇列。

要求

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

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

模擬儲存體服務 URI

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

方法 要求 URI HTTP 版本
DELETE 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-client-request-id 選擇性。 提供用戶端產生的不透明值,具有1個 KiB 字元限制,當啟用儲存體分析記錄時,記錄在分析記錄中。 強烈建議使用此標頭來將用戶端活動與伺服器接收的要求相互關聯。 如需詳細資訊,請參閱關於儲存體分析記錄Azure 記錄:使用記錄檔追蹤儲存體要求

要求本文

無。

回應

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

狀態碼

成功的作業會傳回狀態碼 204 (沒有內容)。

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

回應標頭

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

回應標頭 描述
x-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 標頭不存在於要求中,則回應中不會出現此標頭。

回應本文

無。

授權

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

備註

刪除佇列時,不能至少為30秒建立具有相同名稱的佇列;如果服務仍在處理要求,佇列可能無法使用超過30秒。 正在刪除佇列時,嘗試建立相同名稱的佇列會失敗,並出現狀態碼 409 (衝突) ,而服務會傳回其他錯誤資訊,指出正在刪除佇列。 所有其他作業(包括佇列中任何訊息的作業)將會失敗,且狀態碼 404 (在刪除佇列時找不到) 。

另請參閱

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