本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
刪除檔案系統,永久伺服其內容的存取。傳回時,文件系統不再存在,您無法存取已刪除文件系統的任何內容。
您必須先手動刪除附加至檔案系統的掛載目標,才能刪除 EFS 檔案系統。當您使用 AWS 主控台刪除檔案系統時,會為您執行此步驟。
注意
您無法刪除屬於 EFS 複寫組態的檔案系統。您需要先刪除複寫組態。
您無法刪除正在使用的檔案系統。也就是說,如果檔案系統有任何掛載目標,您必須先刪除它們。如需詳細資訊,請參閱 DescribeMountTargets 和 DeleteMountTarget。
注意
DeleteFileSystem
呼叫會在檔案系統狀態仍處於 deleting
時傳回。因 DescribeFileSystems 操作會傳回您帳戶中的檔案系統清單,所以您可以通過呼叫該操作來檢查檔案系統刪除狀態。如果您傳遞檔案系統 ID 或已刪除檔案系統的建立權杖,則 DescribeFileSystems 會傳回 404 FileSystemNotFound
錯誤。
這項操作需要 elasticfilesystem:DeleteFileSystem
動作的許可。
請求語法
DELETE /2015-02-01/file-systems/FileSystemId
HTTP/1.1
URI 請求參數
請求會使用下列 URI 參數。
- FileSystemId
-
您要刪除的檔案系統 ID。
長度限制:長度上限為 128。
模式:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$
必要:是
請求主體
請求沒有請求主體。
回應語法
HTTP/1.1 204
回應元素
如果動作成功,則服務會送回具有空 HTTP 主體的 HTTP 204 回應。
錯誤
- BadRequest
-
如果請求格式錯誤或包含錯誤,例如無效的參數值或缺少必要參數,則傳回。
HTTP 狀態碼:400
- FileSystemInUse
-
如果檔案系統有掛載目標,則傳回。
HTTP 狀態碼:409
- FileSystemNotFound
-
如果指定的
FileSystemId
值不存在於請求者的 中,則傳回 AWS 帳戶。HTTP 狀態碼:404
- InternalServerError
-
如果伺服器端發生錯誤,則傳回。
HTTP 狀態碼:500
範例
刪除檔案系統
下列範例將 DELETE 請求傳送至 file-systems
端點 (elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567
),以刪除 ID 為 fs-01234567
的檔案系統。
請求範例
DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T233021Z
Authorization: <...>
回應範例
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: