本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
DeleteFileSystem
删除文件系统,永久中止访问其内容。返回后,文件系统不再存在,您无法访问已删除文件系统的任何内容。
在删除 EFS 文件系统之前,需要手动删除连接到文件系统的装载目标。当您使用Amazon控制台删除文件系统时,会为您执行此步骤。
注意
您无法删除作为 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
值不存在,则返回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 的更多信息,请参阅以下内容: