

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Elimina un sistema de archivos, lo que corta de forma permanente el acceso a su contenido. Cuando regrese, el sistema de archivos ya no existe y no podrá acceder a ningún contenido del sistema de archivos eliminado.

Debe eliminar manualmente los destinos de montaje adjuntos a un sistema de archivos antes de poder eliminar un sistema de archivos de EFS. Este paso se realiza automáticamente cuando se utiliza la AWS consola para eliminar un sistema de archivos.

**nota**  
No se puede eliminar un sistema de archivos que forme parte de una configuración de replicación de EFS. Debe eliminarse primero la configuración de replicación.

 No se puede eliminar un sistema de archivos que esté en uso. Es decir, si el sistema de archivos tiene ningún destino de montaje, primero debe eliminarlo. Para obtener más información, consulte [DescribeMountTargets](API_DescribeMountTargets.md) y [DeleteMountTarget](API_DeleteMountTarget.md). 

**nota**  
La llamada `DeleteFileSystem` realiza vuelve mientras el estado del sistema de archivos siga siendo `deleting`. Puede comprobar el estado de eliminación del sistema de archivos llamando a la operación [DescribeFileSystems](API_DescribeFileSystems.md), que devuelve una lista de los sistemas de archivos de su cuenta. Si pasa el identificador del sistema de archivos o el token de creación del sistema de archivos eliminado, [DescribeFileSystems](API_DescribeFileSystems.md) devuelve un error `404 FileSystemNotFound`.

Esta operación necesita permisos para la acción `elasticfilesystem:DeleteFileSystem`.

## Sintaxis de la solicitud
<a name="API_DeleteFileSystem_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_DeleteFileSystem_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **   <a name="efs-DeleteFileSystem-request-uri-FileSystemId"></a>
El ID del sistema de archivos que desea eliminar.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteFileSystem_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteFileSystem_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Elementos de respuesta
<a name="API_DeleteFileSystem_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 204 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteFileSystem_Errors"></a>

 ** BadRequest **   
Se devuelve si la solicitud tiene un formato incorrecto o contiene un error, como un valor de parámetro no válido, o falta un parámetro obligatorio.    
 ** ErrorCode **   
El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.   
 ** Message **   
El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.
Código de estado HTTP: 400

 ** FileSystemInUse **   
Se devuelve si un sistema de archivos tiene objetivos de montaje.    
 ** ErrorCode **   
El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.   
 ** Message **   
El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.
Código de estado HTTP: 409

 ** FileSystemNotFound **   
Se devuelve si el `FileSystemId` valor especificado no existe en el del Cuenta de AWS solicitante.    
 ** ErrorCode **   
El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.   
 ** Message **   
El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.
Código de estado HTTP: 404

 ** InternalServerError **   
Se devuelve si se ha producido un error en el servidor.    
 ** ErrorCode **   
El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.   
 ** Message **   
El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.
Código de estado HTTP: 500

## Ejemplos
<a name="API_DeleteFileSystem_Examples"></a>

### Eliminar un sistema de archivos
<a name="API_DeleteFileSystem_Example_1"></a>

El siguiente ejemplo envía una solicitud DELETE al punto de conexión `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`) para eliminar un sistema de archivos cuyo ID es `fs-01234567`. 

#### Solicitud de muestra
<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: <...>
```

#### Respuesta de ejemplo
<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
```

## Véase también
<a name="API_DeleteFileSystem_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem) 