DeleteFileSystem - Amazon Elastic File System

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

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 conectados a um sistema de arquivos antes de excluir um sistema de EFS arquivos. 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 EFS replicação. É 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 e DeleteMountTarget.

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, 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 retornará um erro 404 FileSystemNotFound.

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

Sintaxe da Solicitação

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

URIParâmetros de solicitação

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

FileSystemId

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})$

Exigido: Sim

Corpo da Solicitação

Essa solicitação não tem corpo.

Sintaxe da resposta

HTTP/1.1 204

Elementos de Resposta

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

Erros

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.

HTTPCódigo de status: 400

FileSystemInUse

Retornado se um sistema de arquivos tiver destinos de montagem.

HTTPCódigo de status: 409

FileSystemNotFound

Retornado se o FileSystemId valor especificado não existir no valor do Conta da AWS solicitante.

HTTPCódigo de status: 404

InternalServerError

Retornado se ocorreu um erro no lado do servidor.

HTTPCódigo de status: 500

Exemplos

Excluir um sistema de arquivos

O exemplo a seguir envia uma DELETE solicitação ao file-systems endpoint (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

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

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

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: