**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á.
# Excluir um arquivo no Amazon Glacier
Você não pode excluir um arquivo usando o console de gerenciamento do Amazon Glacier. Para excluir um arquivo, você deve usar a AWS Command Line Interface (CLI) ou escrever código para fazer uma solicitação de exclusão usando diretamente a API REST ou as AWS SDK para Java bibliotecas wrapper e.NET. Os tópicos a seguir explicam como usar AWS SDK para Java as bibliotecas wrapper e.NET, a API REST e a. AWS CLI
**Topics**
+ [Excluir um arquivo no Amazon Glacier usando o AWS SDK para Java](deleting-an-archive-using-java.md)
+ [Excluindo um arquivo no Amazon Glacier usando o AWS SDK para .NET](deleting-an-archive-using-dot-net.md)
+ [Excluir um arquivo do Amazon Glacier usando a API REST](deleting-an-archive-using-rest.md)
+ [Excluindo um arquivo no Amazon Glacier usando o AWS Command Line Interface](deleting-an-archive-using-cli.md)
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 o 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. Excluir um arquivo já excluído não resulta em um erro.
Depois de excluir um arquivo, se você fizer o download do inventário de cofre imediatamente, ele poderá incluir o arquivo excluído na lista porque o Amazon Glacier prepara o inventário de cofre somente uma vez por dia.
**nota**
Para exclusão automática de arquivos do cofre, consulte [Exclusão automática dos arquivos do cofre no Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/automated-deletion-of-vault-archives-in-amazon-s3-glacier/).
# Excluir um arquivo no Amazon Glacier usando o AWS SDK para Java
Estas são as etapas para excluir um arquivo usando a API de nível inferior do AWS SDK para Java.
1. Crie uma instância da classe `AmazonGlacierClient` (o cliente).
Você precisa especificar uma região da AWS onde o arquivo que deseja excluir está armazenado. Todas as operações realizadas por você usando esse cliente se aplicam a essa regiãoAWS.
1. Forneça informações sobre a solicitação criando uma instância da classe `DeleteArchiveRequest`.
Você precisa fornecer um ID de arquivo, um nome de cofre e o ID da conta. Se você não fornecer um ID da conta, o ID da conta associado às credenciais fornecidas por você para assinar a solicitação será pressuposto. Para obter mais informações, consulte [Usando o AWS SDK para Java com o Amazon Glacier](using-aws-sdk-for-java.md).
1. Execute o método `deleteArchive` fornecendo o objeto de solicitação como um parâmetro.
O trecho de código Java a seguir ilustra as etapas anteriores.
```
AmazonGlacierClient client;
DeleteArchiveRequest request = new DeleteArchiveRequest()
.withVaultName("*** provide a vault name ***")
.withArchiveId("*** provide an archive ID ***");
client.deleteArchive(request);
```
**nota**
Para obter informações sobre a API REST subjacente, consulte [Delete Archive (DELETE archive)](api-archive-delete.md).
## Exemplo: excluir um arquivamento usando a AWS SDK para Java
O exemplo de código do Java a seguir usa o AWS SDK para Java para excluir um arquivo. Para instruções detalhadas sobre como executar esse exemplo, consulte [Executar exemplos do Java para o Amazon Glacier usando o Eclipse](using-aws-sdk-for-java.md#setting-up-and-testing-sdk-java). Você precisa atualizar o código, conforme mostrado, com um nome de cofre e o ID do arquivo que deseja excluir.
**Example**
```
import java.io.IOException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.glacier.AmazonGlacierClient;
import com.amazonaws.services.glacier.model.DeleteArchiveRequest;
public class ArchiveDelete {
public static String vaultName = "*** provide vault name ****";
public static String archiveId = "*** provide archive ID***";
public static AmazonGlacierClient client;
public static void main(String[] args) throws IOException {
ProfileCredentialsProvider credentials = new ProfileCredentialsProvider();
client = new AmazonGlacierClient(credentials);
client.setEndpoint("https://glacier.us-east-1.amazonaws.com/");
try {
// Delete the archive.
client.deleteArchive(new DeleteArchiveRequest()
.withVaultName(vaultName)
.withArchiveId(archiveId));
System.out.println("Deleted archive successfully.");
} catch (Exception e) {
System.err.println("Archive not deleted.");
System.err.println(e);
}
}
}
```
# Excluindo um arquivo no Amazon Glacier usando o AWS SDK para .NET
Tanto o [alto quanto o baixo nível APIs](using-aws-sdk.md) fornecidos pelo Amazon SDK para .NET fornecem um método para excluir um arquivo.
**Topics**
+ [Excluindo um arquivo usando a API de alto nível do AWS SDK para .NET](#delete-archive-using-dot-net-high-level)
+ [Excluindo um arquivo usando a API de baixo nível AWS SDK para .NET](#delete-archive-using-dot-net-low-level)
## Excluindo um arquivo usando a API de alto nível do AWS SDK para .NET
A classe `ArchiveTransferManager` da API de nível superior fornece o método `DeleteArchive` que você pode usar para excluir um arquivo.
### Exemplo: excluir um arquivo usando a API de alto nível do AWS SDK para .NET
O exemplo de código C\$1 a seguir usa a API de alto nível do AWS SDK para .NET para excluir um arquivo. Para step-by-step obter instruções sobre como executar esse exemplo, consulte[Executar exemplos de código](using-aws-sdk-for-dot-net.md#setting-up-and-testing-sdk-dotnet). Você precisa atualizar o código conforme mostrado com o ID do arquivo que deseja excluir.
**Example**
```
using System;
using Amazon.Glacier;
using Amazon.Glacier.Transfer;
using Amazon.Runtime;
namespace glacier.amazon.com.rproxy.govskope.us.docsamples
{
class ArchiveDeleteHighLevel
{
static string vaultName = "examplevault";
static string archiveId = "*** Provide archive ID ***";
public static void Main(string[] args)
{
try
{
var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2);
manager.DeleteArchive(vaultName, archiveId);
Console.ReadKey();
}
catch (AmazonGlacierException e) { Console.WriteLine(e.Message); }
catch (AmazonServiceException e) { Console.WriteLine(e.Message); }
catch (Exception e) { Console.WriteLine(e.Message); }
Console.WriteLine("To continue, press Enter");
Console.ReadKey();
}
}
}
```
## Excluindo um arquivo usando a API de baixo nível AWS SDK para .NET
Veja a seguir as etapas para excluir um arquivo usando o AWS SDK para .NET.
1. Crie uma instância da classe `AmazonGlacierClient` (o cliente).
Você precisa especificar uma AWS região na qual o arquivo que você deseja excluir está armazenado. Todas as operações que você executa usando esse cliente se aplicam a essa AWS região.
1. Forneça informações sobre a solicitação criando uma instância da classe `DeleteArchiveRequest`.
Você precisa fornecer um ID de arquivo, um nome de cofre e o ID da conta. Se você não fornecer um ID da conta, o ID da conta associado às credenciais fornecidas por você para assinar a solicitação será pressuposto. Para obter mais informações, consulte [Usando o AWS SDKs com o Amazon Glacier](using-aws-sdk.md).
1. Execute o método `DeleteArchive` fornecendo o objeto de solicitação como um parâmetro.
### Exemplo: excluir um arquivo usando a API de baixo nível do AWS SDK para .NET
O exemplo do C\$1 a seguir ilustra as etapas anteriores. O exemplo usa a API de baixo nível do AWS SDK para .NET para excluir um arquivo.
**nota**
Para obter informações sobre a API REST subjacente, consulte [Delete Archive (DELETE archive)](api-archive-delete.md).
Para step-by-step obter instruções sobre como executar esse exemplo, consulte[Executar exemplos de código](using-aws-sdk-for-dot-net.md#setting-up-and-testing-sdk-dotnet). Você precisa atualizar o código conforme mostrado com o ID do arquivo que deseja excluir.
**Example**
```
using System;
using Amazon.Glacier;
using Amazon.Glacier.Model;
using Amazon.Runtime;
namespace glacier.amazon.com.rproxy.govskope.us.docsamples
{
class ArchiveDeleteLowLevel
{
static string vaultName = "examplevault";
static string archiveId = "*** Provide archive ID ***";
public static void Main(string[] args)
{
AmazonGlacierClient client;
try
{
using (client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2))
{
Console.WriteLine("Deleting the archive");
DeleteAnArchive(client);
}
Console.WriteLine("Operations successful. To continue, press Enter");
Console.ReadKey();
}
catch (AmazonGlacierException e) { Console.WriteLine(e.Message); }
catch (AmazonServiceException e) { Console.WriteLine(e.Message); }
catch (Exception e) { Console.WriteLine(e.Message); }
Console.WriteLine("To continue, press Enter");
Console.ReadKey();
}
static void DeleteAnArchive(AmazonGlacierClient client)
{
DeleteArchiveRequest request = new DeleteArchiveRequest()
{
VaultName = vaultName,
ArchiveId = archiveId
};
DeleteArchiveResponse response = client.DeleteArchive(request);
}
}
}
```
# Excluir um arquivo do Amazon Glacier usando a API REST
Você pode usar a API Delete Archive para excluir um arquivo.
+ Para obter mais informações sobre a API Delete Archive, consulte [Delete Archive (DELETE archive)](api-archive-delete.md).
+ Para obter informações sobre como usar a API REST, consulte [Referência de API para Amazon Glacier](amazon-glacier-api.md).
# Excluindo um arquivo no Amazon Glacier usando o AWS Command Line Interface
Você pode excluir arquivos no Amazon Glacier (Amazon Glacier) usando AWS Command Line Interface o ().AWS CLI
**Topics**
+ [(Pré-requisito) Configurando o AWS CLI](#Creating-Vaults-CLI-Setup)
+ [Exemplo: Excluindo um arquivo usando o AWS CLI](#Deleting-Archives-CLI-Implementation)
## (Pré-requisito) Configurando o AWS CLI
1. Faça download e configure a AWS CLI. Para obter instruções, consulte os seguintes tópicos no *Guia do usuário do AWS Command Line Interface *:
[Instalando o AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)
[Configurando o AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)
1. Verifique sua AWS CLI configuração inserindo os seguintes comandos no prompt de comando. Esses comandos não fornecem as credenciais explicitamente, de modo que as credenciais do perfil padrão são usadas.
+ Tente usar o comando de ajuda.
```
aws help
```
+ Para obter uma lista dos cofres do Amazon Glacier na conta configurada, use o comando `list-vaults`. *123456789012*Substitua pelo seu Conta da AWS ID.
```
aws glacier list-vaults --account-id 123456789012
```
+ Para ver os dados de configuração atuais do AWS CLI, use o `aws configure list` comando.
```
aws configure list
```
## Exemplo: Excluindo um arquivo usando o AWS CLI
1. Use o comando [https://docs.aws.amazon.com/cli/latest/reference/glacier/initiate-job.html](https://docs.aws.amazon.com/cli/latest/reference/glacier/initiate-job.html) para iniciar um trabalho de recuperação de inventário.
```
aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters="{\"Type\":\"inventory-retrieval\"}"
```
Saída esperada:
```
{
"location": "/111122223333/vaults/awsexamplevault/jobs/*** jobid ***",
"jobId": "*** jobid ***"
}
```
1. Use o comando [https://docs.aws.amazon.com/cli/latest/reference/glacier/describe-job.html](https://docs.aws.amazon.com/cli/latest/reference/glacier/describe-job.html) para verificar o status do trabalho de recuperação anterior.
```
aws glacier describe-job --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid ***
```
Saída esperada:
```
{
"InventoryRetrievalParameters": {
"Format": "JSON"
},
"VaultARN": "*** vault arn ***",
"Completed": false,
"JobId": "*** jobid ***",
"Action": "InventoryRetrieval",
"CreationDate": "*** job creation date ***",
"StatusCode": "InProgress"
}
```
1. Aguarde a conclusão do trabalho .
Você deve aguardar até a saída do trabalho estar pronta para download. Se você definiu uma configuração de notificação no cofre ou especificou um tópico do Amazon Simple Notification Service (Amazon SNS) ao iniciar o trabalho, o Amazon Glacier envia uma mensagem para o tópico depois de concluir o trabalho.
É possível definir a configuração de notificação para eventos específicos no cofre. Para obter mais informações, consulte [Configurar notificações do cofre no Amazon Glacier](configuring-notifications.md). O Amazon Glacier enviará uma mensagem para o tópico do SNS especificado sempre que o evento determinado ocorrer.
1. Quando estiver concluído, use o comando [https://docs.aws.amazon.com/cli/latest/reference/glacier/get-job-output.html](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-job-output.html) para fazer download do trabalho de recuperação para o arquivo `output.json`.
```
aws glacier get-job-output --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid *** output.json
```
Esse comando produz um arquivo com os campos a seguir.
```
{
"VaultARN":"arn:aws:glacier:region:111122223333:vaults/awsexamplevault",
"InventoryDate":"*** job completion date ***",
"ArchiveList":[
{"ArchiveId":"*** archiveid ***",
"ArchiveDescription":*** archive description (if set) ***,
"CreationDate":"*** archive creation date ***",
"Size":"*** archive size (in bytes) ***",
"SHA256TreeHash":"*** archive hash ***"
}
{"ArchiveId":
...
]}
```
1. Use o comando `delete-archive` para excluir cada arquivamento de um cofre até que não haja mais nenhum.
```
aws glacier delete-archive --vault-name awsexamplevault --account-id 111122223333 --archive-id *** archiveid ***
```