

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

# DeleteFileSystem
<a name="API_DeleteFileSystem"></a>

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

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

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

 无法删除正在使用的文件系统。也就是说，如果文件系统有任何挂载目标，必须先删除挂载目标。有关更多信息，请参阅[DescribeMountTargets](API_DescribeMountTargets.md)和[DeleteMountTarget](API_DeleteMountTarget.md)。

**注意**  
当文件系统状态仍为 `deleting` 时，将返回 `DeleteFileSystem` 调用。可以通过调用 [DescribeFileSystems](API_DescribeFileSystems.md) 操作来检查文件系统的删除状态，该操作会返回账户中的文件系统列表。如果传递已删除文件系统的文件系统 ID 或创建令牌，[DescribeFileSystems](API_DescribeFileSystems.md) 会返回 `404 FileSystemNotFound` 错误。

此操作需要 `elasticfilesystem:DeleteFileSystem` 操作的权限。

## 请求语法
<a name="API_DeleteFileSystem_RequestSyntax"></a>

```
DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1
```

## URI 请求参数
<a name="API_DeleteFileSystem_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **   <a name="efs-DeleteFileSystem-request-uri-FileSystemId"></a>
要删除的文件系统 ID。  
长度限制：最大长度为 128。  
模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`  
必需：是

## 请求体
<a name="API_DeleteFileSystem_RequestBody"></a>

该请求没有请求正文。

## 响应语法
<a name="API_DeleteFileSystem_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## 响应元素
<a name="API_DeleteFileSystem_ResponseElements"></a>

如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。

## 错误
<a name="API_DeleteFileSystem_Errors"></a>

 ** BadRequest **   
如果请求格式错误或包含错误（例如参数值无效或缺少必填参数），则返回此内容。    
 ** ErrorCode **   
错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。  
 ** Message **   
错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。
HTTP 状态代码：400

 ** FileSystemInUse **   
如果文件系统有挂载目标，则返回此内容。    
 ** ErrorCode **   
错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。  
 ** Message **   
错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。
HTTP 状态代码：409

 ** FileSystemNotFound **   
如果请求者的指定`FileSystemId`值不存在，则返回。 AWS 账户    
 ** ErrorCode **   
错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。  
 ** Message **   
错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。
HTTP 状态代码：404

 ** InternalServerError **   
如果服务器端发生错误，则返回此内容。    
 ** ErrorCode **   
错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。  
 ** Message **   
错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。
HTTP 状态代码：500

## 示例
<a name="API_DeleteFileSystem_Examples"></a>

### 删除文件系统
<a name="API_DeleteFileSystem_Example_1"></a>

以下示例向 `file-systems` 端点（`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`）发送 DELETE 请求，以删除 ID 为 `fs-01234567` 的文件系统。

#### 示例请求
<a name="API_DeleteFileSystem_Example_1_Request"></a>

```
DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T233021Z
Authorization: <...>
```

#### 示例响应
<a name="API_DeleteFileSystem_Example_1_Response"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
```

## 另请参阅
<a name="API_DeleteFileSystem_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem) 