**Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.**

Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte [Classes de armazenamento do Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. O Amazon Glacier é um serviço independente APIs que armazena dados em cofres e é diferente das classes de armazenamento Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, AWS recomenda as classes de armazenamento [Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), que oferecem uma experiência superior ao cliente com APIs base em buckets S3, disponibilidade Região da AWS total, custos mais baixos e integração de serviços. AWS Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando nossas [Orientações de soluções da AWS para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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á.

# Delete Archive (DELETE archive)
<a name="api-archive-delete"></a>

## Descrição
<a name="api-archive-delete-description"></a>

Essa operação exclui um arquivo de um cofre. Você pode excluir um arquivo por vez de um cofre. Para excluir o arquivo, você deve fornecer o ID de arquivo na solicitação de exclusão. Você pode obter o ID de arquivo fazendo download do inventário do cofre que contém o arquivo. Para obter mais informações sobre como fazer download do inventário de cofre, consulte [Fazer download de um inventário de cofre no Amazon Glacier](vault-inventory.md).

Depois de excluir um arquivo, você ainda poderá fazer uma solicitação bem-sucedida para iniciar um trabalho a fim de recuperar o arquivo excluído, mas o trabalho de recuperação de arquivo falhará. 

Recuperações de arquivo que estejam em andamento para um ID de arquivo quando você exclui o arquivo podem ser bem-sucedidas ou não, de acordo com os seguintes cenários:

 
+ Se o trabalho de recuperação de arquivo estiver preparando ativamente os dados para download quando o Amazon Glacier receber a solicitação de exclusão de arquivo, a operação de recuperação de arquivo poderá falhar. 
+ Se o trabalho de recuperação de arquivo tiver preparado com êxito o arquivo para download quando o Amazon Glacier receber a solicitação de exclusão de arquivo, você poderá fazer download da saída. 

Para obter mais informações sobre recuperação de arquivo, consulte [Baixando um arquivo no Amazon Glacier](downloading-an-archive.md). 

Essa operação é idempotente. Tentar excluir um arquivo já excluído não resulta em um erro. 

## Solicitações
<a name="api-archive-delete-requests"></a>

Para excluir um arquivo, você envia uma solicitação `DELETE` para o URI do recurso.

### Sintaxe
<a name="api-archive-delete-requests-syntax"></a>

```
1. DELETE /AccountId/vaults/VaultName/archives/ArchiveID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. x-amz-Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**nota**  
O valor de `AccountId` é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID da Conta da AWS ou, de opcionalmente, um '`-`' (hífen) único. Nesse caso, o Amazon Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.

### Parâmetros da solicitação
<a name="api-archive-delete-requests-parameters"></a>

Essa operação não usa parâmetros de solicitação.

### Cabeçalhos de solicitação
<a name="api-archive-delete-requests-headers"></a>

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md).

### Corpo da Solicitação
<a name="api-archive-delete-requests-elements"></a>

Essa operação não tem um corpo de solicitação.

## Respostas
<a name="api-archive-delete-responses"></a>

### Sintaxe
<a name="api-archive-delete-responses-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### Cabeçalhos de resposta
<a name="api-archive-delete-responses-headers"></a>

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).

### Corpo da resposta
<a name="api-archive-delete-responses-elements"></a>

Essa operação não retorna um corpo de resposta.

### Erros
<a name="api-archive-delete-responses-errors"></a>

Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md).

## Exemplos
<a name="api-archive-delete-examples"></a>

O exemplo a seguir demonstra como excluir um arquivo do cofre chamado `examplevault`.

### Exemplo de solicitação
<a name="api-archive-delete-example-request"></a>

O ID do arquivo a ser excluído é especificado como um sub-recurso de `archives`.

```
1. DELETE /-/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### Exemplo de resposta
<a name="api-archive-delete-example-response"></a>

Se a solicitação for bem-sucedida, o Amazon Glacier responderá com `204 No Content` para indicar que o arquivo é excluído.

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```

## Seções relacionadas
<a name="related-sections-archive-delete"></a>

 
+ [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Upload Archive (POST archive)](api-archive-post.md)
+ [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)