

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Exclui um sistema de arquivos rompendo permanentemente o acesso a seu conteúdo. Ao retornar, o sistema de arquivos não existe mais e você não pode acessar nenhum conteúdo do sistema de arquivos excluído.

Você precisa excluir manualmente os destinos de montagem anexados a um sistema de arquivos antes de excluir um sistema de arquivos EFS. Essa etapa é executada quando você usa o AWS console para excluir um sistema de arquivos.

**nota**  
Você não pode excluir um sistema de arquivos que faz parte de uma configuração de replicação do EFS. É necessário excluir a configuração de replicação primeiro.

 Não é possível excluir um sistema de arquivos que esteja em uso. Ou seja, se o sistema de arquivos tiver algum destino de montagem, você deverá primeiro excluí-lo. Para obter mais informações, consulte [DescribeMountTargets](API_DescribeMountTargets.md) e [DeleteMountTarget](API_DeleteMountTarget.md). 

**nota**  
A chamada `DeleteFileSystem` retorna enquanto o estado do ciclo de vida do sistema de arquivos ainda for `deleting`. Você pode verificar o status de exclusão do sistema de arquivos chamando a operação [DescribeFileSystems](API_DescribeFileSystems.md), que retorna uma lista dos sistemas de arquivos em sua conta. Se você passar o ID do sistema de arquivos ou o token de criação para o sistema de arquivos excluído, o [DescribeFileSystems](API_DescribeFileSystems.md) retornará um erro `404 FileSystemNotFound`.

Essa operação exige permissões para a ação `elasticfilesystem:DeleteFileSystem`.

## Sintaxe da Solicitação
<a name="API_DeleteFileSystem_RequestSyntax"></a>

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

## Parâmetros da Solicitação de URI
<a name="API_DeleteFileSystem_RequestParameters"></a>

A solicitação usa os seguintes parâmetros de URI:

 ** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **   <a name="efs-DeleteFileSystem-request-uri-FileSystemId"></a>
O ID do sistema de arquivos que você deseja excluir.  
Restrições de Tamanho: Tamanho máximo de 128.  
Padrão: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
Obrigatório: Sim

## Corpo da Solicitação
<a name="API_DeleteFileSystem_RequestBody"></a>

Essa solicitação não tem corpo.

## Sintaxe da resposta
<a name="API_DeleteFileSystem_ResponseSyntax"></a>

```
HTTP/1.1 204
```

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 204 com um corpo HTTP vazio.

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

 ** BadRequest **   
Retornado se a solicitação estiver malformada ou contiver um erro, como um valor de parâmetro inválido ou um parâmetro obrigatório ausente.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 400

 ** FileSystemInUse **   
Retornado se um sistema de arquivos tiver destinos de montagem.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de Status HTTP: 409

 ** FileSystemNotFound **   
Retornado se o `FileSystemId` valor especificado não existir no valor do Conta da AWS solicitante.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 404

 ** InternalServerError **   
Retornado se ocorreu um erro no lado do servidor.    
 ** ErrorCode **   
O código de erro é uma sequência que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo.   
 ** Message **   
A mensagem de erro contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a mensagem de erro.
Código de status HTTP: 500

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

### Excluir um sistema de arquivos
<a name="API_DeleteFileSystem_Example_1"></a>

O exemplo a seguir envia uma solicitação DELETE ao endpoint `file-systems` (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`) para excluir um sistema de arquivos cujo ID é `fs-01234567`. 

#### Exemplo de solicitação
<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: <...>
```

#### Resposta da amostra
<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
```

## Consulte também
<a name="API_DeleteFileSystem_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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) 