操作會 Delete Container 刪除指定的容器。
Request
您可以建構 Delete Container 要求，如下所示。 建議使用 HTTPS。 以記憶體帳戶的名稱取代 myaccount。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
DELETE |
https://myaccount.blob.core.windows.net/mycontainer?restype=container |
HTTP/1.1 |
模擬儲存體服務 URI
當您對類比記憶體服務發出請求時，請將模擬器主機名和 Azure Blob 儲存埠指定為 127.0.0.1:10000，後跟類比的儲存帳戶名稱。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
DELETE |
http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container |
HTTP/1.1 |
有關詳細資訊，請參閱 使用 Azurite 模擬器進行本地 Azure 儲存開發。
URI 參數
你可以在請求 URI 上指定以下額外參數。
| 參數 | Description |
|---|---|
timeout |
Optional. 參數以 timeout 秒為單位。 如需詳細資訊，請參閱 設定 Blob 儲存體作業的逾時。 |
請求標頭
下表說明必要和選用的要求標頭。
| 請求標頭 | Description |
|---|---|
Authorization |
Required. 指定授權配置、帳戶名稱和簽章。 如需詳細資訊，請參閱 授權對 Azure 記憶體的要求。 |
Date 或 x-ms-date |
Required. 指定要求的國際標準時間（UTC）。 如需詳細資訊，請參閱 授權對 Azure 記憶體的要求。 |
x-ms-lease-id: <ID> |
若貨櫃有有效租約，則需於2012-02-12版本及之後使用。 若要呼叫 Delete Container 擁有有效租約的容器，請在此標頭中指定租約 ID。 如果在有有效租約時未指定此標頭， Delete Container 則會回傳 409（衝突）錯誤。 如果你指定錯誤的租約 ID，或在沒有有效租約的貨櫃上填寫租約 ID，會 Delete Container 回傳 412（前提條件失敗）錯誤。 |
x-ms-version |
所有授權請求都需要。 指定要用於此要求的作業版本。 如需詳細資訊，請參閱 Azure 儲存體服務的版本。 |
x-ms-client-request-id |
Optional. 提供用戶端產生的不透明值，其字元限制為 1 KB （KiB），該字元限制會在設定記錄時記錄在記錄中。 強烈建議您使用此標頭，將用戶端活動與伺服器收到的要求建立關聯。 如需詳細資訊，請參閱 監視 Azure Blob 儲存體。 |
此操作也支援使用條件標頭，僅在符合指定條件時刪除容器。 如需詳細資訊，請參閱 指定 Blob 儲存體作業的條件式標頭。
請求主體
None.
範例要求
Request Syntax:
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1
Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 21:44:34 GMT
Authorization: SharedKey devstoreaccount1:t7mf5htNuwLFX9g0S2LDdRtRn1FQzMAluBvHy1QPpnM=
回應
回應包含 HTTP 狀態代碼和一組響應標頭。
狀態代碼
成功的作業會傳回狀態代碼 202（已接受）。 如需狀態碼的相關資訊，請參閱 狀態和錯誤碼。
回應標頭
此作業的回應包含下列標頭。 回應也可以包含其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規範。
| 回應標頭 | Description |
|---|---|
x-ms-request-id |
此標頭可唯一識別已提出的要求，並可用於對要求進行疑難解答。 如需詳細資訊，請參閱 疑難排解 API 作業。 |
x-ms-version |
指出用來執行要求的 Blob 記憶體版本。 針對 2009-09-19 版和更新版本提出的要求會傳回此標頭。 |
Date |
UTC 日期/時間值，指出起始回應的時間。 服務會產生此值。 |
x-ms-client-request-id |
您可以使用此標頭來針對要求和對應的回應進行疑難解答。 如果請求中存在標頭，則此標頭的值等於標頭的 x-ms-client-request-id 值。 該值最多為 1,024 個可見的 ASCII 字元。 如果要求中沒有 x-ms-client-request-id 標頭，此標頭就不會出現在回應中。 |
回應機構
None.
範例回應
Response Status:
HTTP/1.1 202 Accepted
Response Headers:
Transfer-Encoding: chunked
Content-Type: application/xml
Date: Sun, 25 Sep 2011 21:45:00 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
Authorization
在 Azure 儲存體中呼叫任何資料存取作業時，需要授權。 您可以授權 Delete Container 作業，如下所示。
Important
Microsoft建議搭配受控識別使用 Microsoft Entra ID 來授權對 Azure 記憶體的要求。 相較於共用密鑰授權，Microsoft Entra ID 提供更高的安全性和易於使用性。
Azure 儲存體支援使用 Microsoft Entra ID 來授權對 Blob 資料的要求。 使用 Microsoft Entra 識別符，您可以使用 Azure 角色型存取控制 （Azure RBAC） 將權限授與安全性主體。 安全性主體可能是使用者、群組、應用程式服務主體或 Azure 受控識別。 安全性主體是由 Microsoft Entra ID 進行驗證，以傳回 OAuth 2.0 權杖。 權杖接著可以用來授權對 Blob 服務的要求。
若要深入瞭解使用 Microsoft Entra 識別符進行授權，請參閱 使用 Microsoft Entra ID授權 Blob 存取權。
Permissions
以下列出Microsoft Entra 使用者、群組、受控識別或服務主體呼叫 Delete Container 作業所需的 RBAC 動作，以及包含此動作的最低特殊許可權內建 Azure RBAC 角色：
- Azure RBAC action：Microsoft.Storage/storageAccounts/blobServices/containers/delete
- 最低許可權內建角色：儲存體 Blob 資料參與者
若要深入瞭解如何使用 Azure RBAC 指派角色，請參閱 指派 Azure 角色以存取 Blob 資料。
Remarks
當容器被刪除時，同名的容器至少要等 30 秒才能建立。 如果服務仍在處理請求，容器可能無法使用超過 30 秒。 在容器被刪除時，嘗試建立同名容器時，會因狀態碼 409（衝突）而失敗。 服務顯示該容器正在被刪除。 容器內對 blob 的操作，包括讀寫，在刪除請求被接受後 ，可能持續成功長達 30 秒 。 在此期間結束後，容器及其 blob 的所有操作都會失敗，狀態代碼為 404（未找到）。
Billing
儲存體帳戶不會針對要求收費 Delete Container 。