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

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

DeleteFileSystem

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

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

注意

您无法删除作为 EFS 复制配置一部分的文件系统。您需要先删除复制配置。

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

注意

当文件系统状态仍处于状态时,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值不存在,则返回Amazon Web Services 账户。

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 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: