刪除目錄

發行項
02/21/2025

Delete Directory 作業會移除指定的空白目錄。請注意，目錄必須空白，才能刪除目錄。啟用 NFS 通訊協定的檔案共用版本 2025-05-05 和更新版本支援這項作業。

通訊協定可用性

已啟用檔案共享通訊協定	可用
SMB
NFS

請求

Delete Directory 要求建構方式如下。建議您使用 HTTPS。

方法	要求 URI	HTTP 版本
刪除	`https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory`	HTTP/1.1

以您自己的方式取代要求 URI 中顯示的路徑元件，如下所示：

路徑元件	描述
`myaccount`	記憶體帳戶的名稱。
`myshare`	檔案共享的名稱。
`myparentdirectorypath`	自選。父目錄的路徑。
`mydirectory`	目錄的名稱。

如需路徑命名限制的詳細資訊，請參閱命名和參考共用、目錄、檔案和元資料。

URI 參數

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

參數	描述
`timeout`	自選。 timeout 參數是以秒為單位來表示。如需詳細資訊，請參閱設定 Azure 檔案服務的逾時。

要求標頭

下表說明必要和選擇性的要求標頭：

常見的要求標頭

要求標頭	描述
`Authorization`	必填。指定授權配置、帳戶名稱和簽章。如需詳細資訊，請參閱授權對 Azure 記憶體的要求。
`Date` 或 `x-ms-date`	必填。指定要求的國際標準時間（UTC）。如需詳細資訊，請參閱授權對 Azure 記憶體的要求
`x-ms-version`	所有已授權要求的必要專案。指定要用於此要求的作業版本。啟用 NFS 通訊協定的檔案共用版本 2025-05-05 和更新版本支援這項作業。如需詳細資訊，請參閱 Azure 記憶體服務的版本設定。
`x-ms-client-request-id`	自選。提供客戶端產生的不透明值，其中包含設定記錄時記錄的 1-kibibyte （KiB）字元限制。強烈建議您使用此標頭，將用戶端活動與伺服器接收的要求相互關聯。如需詳細資訊，請參閱監視 Azure 檔案服務。
`x-ms-file-request-intent`	如果 `Authorization` 標頭指定 OAuth 令牌，則為必要項。可接受的值為 `backup`。如果 `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` 或 `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` 包含在指派給使用 `Authorization` 標頭授權的身分識別中，則此標頭指定應授與 `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` 或 `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action`。適用於 2022-11-02 版和更新版本。
`x-ms-allow-trailing-dot: { <Boolean> }`	自選。版本 2022-11-02 和更新版本。布爾值會指定是否應該修剪要求 URL 中的尾端點。如果目標位於已啟用 NFS 通訊協定的檔案共用上，預設支援尾端點，則會忽略此標頭。如需詳細資訊，請參閱命名和參考共用、目錄、檔案和元資料。

僅限SMB要求標頭

沒有。

僅限 NFS 要求標頭

沒有。

要求本文

沒有。

範例要求

Request Syntax:  
DELETE https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1  
  
Request Headers:  
x-ms-version: 2014-02-14  
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

回應

回應包含 HTTP 狀態代碼和一組響應標頭。

狀態代碼

成功的作業會傳回狀態代碼 202（已接受）。如您需狀態代碼的相關資訊，請參閱狀態和錯誤碼。

回應標頭

此作業的回應包含下表中的標頭。回應也可以包含額外的標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格，。

常見的響應標頭

回應標頭	描述
`x-ms-request-id`	此標頭可唯一識別已提出的要求，並可用於對要求進行疑難解答。如需詳細資訊，請參閱針對 API 作業進行疑難解答。
`x-ms-version`	指出用來執行要求的 Azure 檔案服務版本。
`Date`	UTC 日期/時間值，指出起始響應的時間。服務會產生此值。
`x-ms-client-request-id`	您可以使用此標頭來針對要求和對應的回應進行疑難解答。如果要求中有 `x-ms-client-request-id` 標頭的值，則此標頭的值等於。此值最多為 1,024 個可見的 ASCII 字元。如果要求中沒有 `x-ms-client-request-id` 標頭，此標頭就不會出現在回應中。

僅限SMB回應標頭

沒有。

僅限 NFS 回應標頭

沒有。

回應本文

沒有。

範例回應

Response Status:  
HTTP/1.1 202 Accepted  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-Type: application/xml  
Date: Mon, 27 Jan 2014 21:45:00 GMT  
x-ms-version: 2014-02-14  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

授權

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

言論

如果您嘗試刪除不是空的目錄，服務會傳回錯誤 409 （目錄非空白）。

在用戶端收到狀態代碼 202（已接受）之後，目錄已從系統移除，且有資格重新建立。取得目錄屬性的後續呼叫會導致錯誤 404 （找不到）。

共用快照集不支援 Delete Directory，這是共用的唯讀複本。如果您嘗試在共用快照集上執行這項作業，服務會傳回錯誤 400 （無效的查詢參數值）。

另請參閱

目錄上的作業

共用方式為