

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

# Baixando um arquivo no Amazon Glacier usando o AWS CLI
<a name="downloading-an-archive-using-cli"></a>

Você pode baixar 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: Baixe um arquivo usando o AWS CLI](#Downloading-Archives-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: Baixe um arquivo usando o AWS CLI
<a name="Downloading-Archives-CLI-Implementation"></a>
**nota**  
Para baixar seus arquivos, você deve saber seus IDs de arquivo. As etapas 1 a 4 recuperar seus IDs de arquivo. Se você já conhece os IDs de arquivo que deseja baixar, vá para a etapa 5.

1. Use o comando `initiate-job` para iniciar um trabalho de recuperação de inventário. O relatório de inventário listará seus IDs de arquivo.

   ```
   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 comando de trabalho `` 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`. Esse arquivo conterá seus IDs de arquivo. 

   ```
   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 `initiate-job` para iniciar o processo de recuperação de cada arquivo a partir de um cofre. Você precisará especificar o parâmetro do trabalho conforme a `archive-retrieval` mostrada abaixo.

   ```
   aws glacier initiate-job --vault-name {{awsexamplevault}} --account-id {{111122223333}} --job-parameters="{\"Type\":\"archive-retrieval\",\"ArchiveId\":\"{{*** archiveId ***}}\"}"
   ```

1. Aguarde a conclusão do trabalho `archive-retrieval`. 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 ***}}
   ```

1. Quando o trabalho acima estiver concluído, use o comando `get-job-output` para baixar seu arquivo.

   ```
   aws glacier get-job-output --vault-name {{awsexamplevault}} --account-id {{111122223333}} --job-id {{*** jobid ***}} output_file_name
   ```