DeleteFileSystem - Amazon Elastic File System
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

DeleteFileSystem

删除文件系统,永久中止访问其内容。返回后,文件系统不再存在,无法访问已删除文件系统的任何内容。

在删除 EFS 文件系统之前,需要手动删除挂载到文件系统的挂载目标。使用 Amazon 控制台删除文件系统时,会为您执行此步骤。

注意

无法删除属于 EFS 复制配置的文件系统。需要先删除复制配置。

无法删除正在使用的文件系统。也就是说,如果文件系统有任何挂载目标,必须先删除挂载目标。有关更多信息,请参阅 DescribeMountTargetsDeleteMountTarget

注意

当文件系统状态仍为 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

如果请求者的 Amazon Web Services 账户中不存在指定的 FileSystemId 值,则返回此内容。

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

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: