本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
DeleteFileSystem
删除文件系统,永久中止访问其内容。返回后,文件系统不再存在,无法访问已删除文件系统的任何内容。
在删除 EFS 文件系统之前,需要手动删除挂载到文件系统的挂载目标。此步骤是在您使用 AWS 控制台删除文件系统时为您执行的。
注意
您无法删除属于 EFS 复制配置的文件系统。需要先删除复制配置。
无法删除正在使用的文件系统。也就是说,如果文件系统有任何挂载目标,必须先删除挂载目标。有关更多信息,请参阅DescribeMountTargets 和DeleteMountTarget。
注意
当文件系统状态仍为 deleting
时,将返回 DeleteFileSystem
调用。可以通过调用 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
示例
删除文件系统
以下示例向 file-systems
端点(elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567
)发送 DELETE 请求,以删除 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
另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs,请参阅以下内容: