DeleteFileSystem - Amazon Elastic File System

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

DeleteFileSystem

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

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

注意

您无法删除属于 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

如果请求者的指定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,请参阅以下内容: