

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

# 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}}
   ```