

 **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 cofre no Amazon Glacier
<a name="deleting-vaults"></a>

O Amazon Glacier excluirá um cofre somente se não houver arquivos no cofre até o último inventário computado e se não houver gravações no cofre desde o inventário mais recente. Para obter informações sobre como excluir arquivos, consulte . [Excluir um arquivo no Amazon Glacier](deleting-an-archive.md). Para obter mais informações sobre como fazer download de um inventário de cofre, consulte ., [Fazer download de um inventário de cofre no Amazon Glacier](vault-inventory.md). 

 

**nota**  
O Amazon Glacier prepara um inventário para cada cofre periodicamente, a cada 24 horas. Como o inventário pode não refletir as informações mais recentes, o Amazon Glacier garante que o cofre esteja realmente vazio verificando se houve alguma operação de gravação desde o último inventário do cofre. 

**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/).

**Topics**
+ [

# Excluir um cofre no Amazon Glacier usando AWS SDK para Java
](deleting-vaults-sdk-java.md)
+ [

# Excluir um cofre no Amazon Glacier usando AWS SDK para .NET
](deleting-vaults-sdk-dotnet.md)
+ [

# Excluir um cofre no Amazon Glacier usando a API REST
](deleting-vault-rest-api.md)
+ [

# Excluir um cofre vazio usando o console do Amazon Glacier
](deleting-vaults-console.md)
+ [

# Excluindo um cofre no Amazon Glacier usando o AWS Command Line Interface
](deleting-vaults-cli.md)

# Excluir um cofre no Amazon Glacier usando AWS SDK para Java
<a name="deleting-vaults-sdk-java"></a>

Estas são as etapas para excluir um cofre usando-se 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 deseja excluir um cofre. 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 `DeleteVaultRequest`.

   Você precisa fornecer o nome do 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 `deleteVault` fornecendo o objeto de solicitação como um parâmetro. 

   O Amazon Glacier exclui o cofre somente se ele estiver vazio. Para obter mais informações, consulte [Delete Vault (DELETE vault)](api-vault-delete.md).

O trecho de código Java a seguir ilustra as etapas anteriores. 

 

```
try {
    DeleteVaultRequest request = new DeleteVaultRequest()
        .withVaultName("*** provide vault name ***");

    client.deleteVault(request);
    System.out.println("Deleted vault: " + vaultName);
} catch (Exception e) {
    System.err.println(e.getMessage());
}
```

**nota**  
Para obter informações sobre a API REST subjacente, consulte [Delete Vault (DELETE vault)](api-vault-delete.md). 

## Exemplo: excluir um cofre usando o AWS SDK para Java
<a name="deleting-vaults-sdk-java-example"></a>

Para obter um exemplo de código funcional, consulte [Exemplos: como criar um cofre usando a AWS SDK para Java](creating-vaults-sdk-java.md#creating-vaults-sdk-java-example). O exemplo de código do Java mostra as operações de cofre básicas, inclusive criar e excluir cofre. 

# Excluir um cofre no Amazon Glacier usando AWS SDK para .NET
<a name="deleting-vaults-sdk-dotnet"></a>

As [APIs de nível superior inferior](using-aws-sdk.md) disponibilizadas pelo Amazon SDK for .NET fornecem um método para excluir um cofre.

**Topics**
+ [

## Excluir um cofre usando a API de nível superior do AWS SDK para .NET
](#deleting-vault-sdk-dotnet-high-level)
+ [

## Excluir um cofre usando a API de nível inferior do AWS SDK para .NET
](#deleting-vault-sdk-dotnet-low-level)

## Excluir um cofre usando a API de nível superior do AWS SDK para .NET
<a name="deleting-vault-sdk-dotnet-high-level"></a>

A classe `ArchiveTransferManager` da API de nível superior fornece o método `DeleteVault` que você pode usar para excluir um cofre.

### Exemplo: excluir um cofre usando a API de nível superior do AWS SDK para .NET
<a name="deleting-vaults-sdk-dotnet-high-level-example"></a>

Para obter um exemplo de código funcional, consulte [Exemplo: operações do Vault usando a API de alto nível do AWS SDK para .NET](creating-vaults-dotnet-sdk.md#vault-operations-example-dotnet-highlevel). O exemplo de código do C\$1 mostra as operações de cofre básicas, inclusive criar e excluir cofre. 

## Excluir um cofre usando a API de nível inferior do AWS SDK para .NET
<a name="deleting-vault-sdk-dotnet-low-level"></a>

Veja a seguir as etapas para excluir um cofre usando o console do AWS SDK para .NET.

 

1. Crie uma instância da classe `AmazonGlacierClient` (o cliente). 

   Você precisa especificar uma região da AWS onde deseja excluir um cofre. 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 `DeleteVaultRequest`.

   Você precisa fornecer o nome do 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 [Como usar o AWS SDK para .NET com o Amazon Glacier](using-aws-sdk-for-dot-net.md). 

1. Execute o método `DeleteVault` fornecendo o objeto de solicitação como um parâmetro. 

   O Amazon Glacier exclui o cofre somente se ele estiver vazio. Para obter mais informações, consulte [Delete Vault (DELETE vault)](api-vault-delete.md).

O trecho de código do C\$1 a seguir ilustra as etapas anteriores. O trecho recupera informações de metadados de um cofre existente na região AWS padrão. 

```
AmazonGlacier client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USEast1);

DeleteVaultRequest request = new DeleteVaultRequest()
{
  VaultName = "*** provide vault name ***"
};

DeleteVaultResponse response = client.DeleteVault(request);
```

**nota**  
Para obter informações sobre a API REST subjacente, consulte [Delete Vault (DELETE vault)](api-vault-delete.md).

### Exemplo: excluir um cofre usando a API de nível inferior do AWS SDK para .NET
<a name="creating-vaults-sdk-dotnet-low-level-example"></a>

Para obter um exemplo de código funcional, consulte [Exemplo: operações do Vault usando a API de baixo nível do AWS SDK para .NET](creating-vaults-dotnet-sdk.md#vault-operations-example-dotnet-lowlevel). O exemplo de código do C\$1 mostra as operações de cofre básicas, inclusive criar e excluir cofre. 

# Excluir um cofre no Amazon Glacier usando a API REST
<a name="deleting-vault-rest-api"></a>

Para excluir um cofre usando a API REST, consulte [Delete Vault (DELETE vault)](api-vault-delete.md).

# Excluir um cofre vazio usando o console do Amazon Glacier
<a name="deleting-vaults-console"></a>

**nota**  
Se for excluir um cofre que não esteja vazio, será necessário primeiro excluir todos os arquivos existentes antes de excluir o cofre. Você pode fazer isso escrevendo um código para fazer uma solicitação de exclusão de arquivamento usando a API REST AWS SDK para Java, a AWS SDK para .NET, a ou usando a AWS Command Line Interface (AWS CLI). Para obter informações sobre como excluir arquivos, consulte [Etapa 5: excluir um arquivo de um cofre no Amazon Glacier](getting-started-delete-archive.md).

Depois que o cofre estiver vazio, você poderá excluí-lo utilizando as seguintes etapas.

**Para excluir um cofre vazio usando o console do Amazon Glacier**

1. Faça login Console de gerenciamento da AWS e abra o console do Amazon Glacier no [Amazon Glacier](https://console.aws.amazon.com/glacier/home) Console.

1. Em **Selecionar uma região**, escolha Região da AWS onde o cofre existe.

1. No painel de navegação à esquerda, selecione **Cofres**.

1. Na lista **Cofres**, selecione a opção ao lado do nome do cofre que você deseja excluir e escolha **Excluir** na parte superior da página.

1. Na caixa de diálogo **Excluir cofre**, confirme que deseja excluir o cofre escolhendo **Excluir**. 
**Importante**  
A exclusão de um cofre não pode ser desfeita.

1. Para verificar se você excluiu o cofre, abra a lista **Cofres** e insira o nome do cofre que você excluiu. Se não for possível encontrar o cofre, sua exclusão foi bem-sucedida. 

# Excluindo um cofre no Amazon Glacier usando o AWS Command Line Interface
<a name="deleting-vaults-cli"></a>

É possível excluir cofres vazios e não vazios no Amazon Glacier usando AWS Command Line Interface (AWS CLI).

**Topics**
+ [

## (Pré-requisito) Configurando o AWS CLI
](#Creating-Vaults-CLI-Setup)
+ [

## Exemplo: Excluindo um cofre vazio usando o AWS CLI
](#Deleting-Empty-Vaults-CLI-Implementation)
+ [

## Exemplo: Excluindo um cofre não vazio usando o AWS CLI
](#Deleting-A-Nonempty-Vaults-CLI-Implementation)

## (Pré-requisito) Configurando o AWS CLI
<a name="Creating-Vaults-CLI-Setup"></a>

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 cofre vazio usando o AWS CLI
<a name="Deleting-Empty-Vaults-CLI-Implementation"></a>
+ Use o comando `delete-vault` para excluir um cofre que não contém arquivamentos.
  + 

    ```
    aws glacier delete-vault --vault-name awsexamplevault --account-id 111122223333
    ```

## Exemplo: Excluindo um cofre não vazio usando o AWS CLI
<a name="Deleting-A-Nonempty-Vaults-CLI-Implementation"></a>

O Amazon Glacier excluirá um cofre somente se não houve arquivamentos nem gravações nesse cofre desde o último inventário computado. A exclusão de um cofre não vazio é um processo de três etapas: recuperar o arquivo IDs do relatório de inventário de um cofre, excluir cada arquivo e, em seguida, excluir o cofre.

1. Use o comando `initiate-job` 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 `describe-job` 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 Notiﬁcation 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 `get-job-output` 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 ***"
   ```
**nota**  
Se o seu ID de arquivo começar com um hífen ou outro caractere especial, você precisará colocá-lo entre aspas para executar esse comando.

1. Use o comando `initiate-job` para iniciar um novo trabalho de recuperação de inventário.

   ```
   aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters '{"Type": "inventory-retrieval"}'
   ```

1. Quando estiver concluído, use o comando `delete-vault` para excluir um cofre sem arquivamentos.

   ```
   aws glacier delete-vault --vault-name awsexamplevault --account-id 111122223333
   ```