刪除容器
Delete Container 作業會標示要刪除的指定容器。 其中包含的容器和任何 Blob 稍後會在記憶體回收時刪除。
要求
您可以依照下列方式建構 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 上指定下列其他參數。
| 參數 | 描述 |
|---|---|
timeout |
選擇性。 timeout 參數以秒為單位。 如需詳細資訊，請參閱 設定 Blob 記憶體作業的逾時。 |
要求標頭
下表描述必要的和選用的要求標頭。
| 要求標頭 | 描述 |
|---|---|
Authorization |
必要。 指定授權配置、帳戶名稱和簽章。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。 |
Date 或 x-ms-date |
必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。 |
x-ms-lease-id: <ID> |
如果容器具有使用中租用，則需要 2012-02-12 版和更新版本。 若要在具有作用中租用的容器上呼叫 Delete Container，請在此標頭中指定租用識別碼。 如果沒有使用中租用時指定此標頭， Delete Container 則傳回 409 (衝突) 錯誤。 如果您在沒有使用中租用 Delete Container 的容器上指定錯誤的租用標識符，則傳回 412 (前置條件失敗) 錯誤。 |
x-ms-version |
所有授權要求都需要。 指定用於這個要求的作業版本。 如需詳細資訊，請參閱 Azure 儲存體服務的版本。 |
x-ms-client-request-id |
選擇性。 提供客戶端產生的不透明值，其中包含 1-kibibyte (KiB) 設定記錄時記錄在記錄中的字元限制。 強烈建議您使用此標頭，將用戶端活動與伺服器收到的要求相互關聯。 如需詳細資訊，請參閱監視 Azure Blob 儲存體。 |
唯有在符合指定條件的情況下，此作業也可支援使用條件式標頭將容器刪除。 如需詳細資訊，請參閱 指定 Blob 記憶體作業的條件標頭。
要求本文
無。
範例要求
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 通訊協議規格。
| 回應標頭 | 描述 |
|---|---|
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如果要求中沒有標頭，則此標頭不會出現在回應中。 |
回應本文
無。
範例回應
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
授權
在 Azure 記憶體中呼叫任何數據存取作業時，需要授權。 您可以授權 Delete Container 作業，如下所示。
Azure 記憶體支援使用 Microsoft Entra ID 來授權 Blob 數據的要求。 使用 Microsoft Entra ID，您可以使用 Azure 角色型存取控制 (Azure RBAC) ，將許可權授與安全性主體。 安全性主體可能是使用者、群組、應用程式服務主體或 Azure 受控識別。 安全性主體是由 Microsoft Entra ID 驗證，以傳回 OAuth 2.0 令牌。 權杖接著可以用來授權對 Blob 服務的要求。
若要深入瞭解使用 Microsoft Entra ID 授權，請參閱使用 Microsoft Entra ID 授權 Blob 的存取權。
權限
以下是 Microsoft Entra 使用者、群組或服務主體呼叫Delete Container作業所需的 RBAC 動作，以及包含此動作的最低特殊許可權 Azure RBAC 角色：
- Azure RBAC 動作：Microsoft.Storage/storageAccounts/blobServices/containers/delete
- 最低特殊許可權內建角色：記憶體 Blob 數據參與者
若要深入瞭解如何使用 Azure RBAC 指派角色，請參閱 指派 Azure 角色以存取 Blob 數據。
備註
刪除容器時，無法建立具有相同名稱的容器至少 30 秒。 如果服務仍在處理要求，容器可能無法超過30秒。 刪除容器時，嘗試建立相同名稱的容器失敗，狀態代碼為 409 (Conflict) 。 服務指出正在刪除容器。 所有其他作業，包括容器下任何 Blob 上的作業，在刪除容器時，狀態代碼 404 (找不到) 失敗。
計費
記憶體帳戶不會支付 Delete Container 要求的費用。