

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

# Etapa 4: fazer download de um arquivo desde um cofre no Amazon Glacier
<a name="getting-started-download-archive"></a>

Nesta etapa, você fará download do arquivo de exemplo do qual fez upload anteriormente em [Etapa 3: fazer upload de um arquivo para um cofre no Amazon Glacier](getting-started-upload-archive.md).

 

**Importante**  
O Amazon Glacier fornece um console. No entanto, qualquer operação de arquivamento, como upload, download ou exclusão, exige que você use a AWS Command Line Interface (CLI) ou escreva código. Não há suporte ao console para operações de arquivo. Por exemplo, para fazer upload de dados, como fotos, vídeos e outros documentos, você deve usar o código AWS CLI ou escrever o código para fazer solicitações, usando a API REST diretamente ou usando AWS SDKs o.   
Para instalar o AWS CLI, consulte [AWS Command Line Interface](https://aws.amazon.com/cli/). Para obter mais informações sobre o uso do Amazon Glacier com o AWS CLI, consulte [AWS CLI Referência do Amazon Glacier.](https://docs.aws.amazon.com/cli/latest/reference/glacier/index.html) Para exemplos de uso do AWS CLI para fazer upload de arquivos para o Amazon Glacier, consulte [Usando o Amazon Glacier](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-glacier.html) com o. AWS Command Line Interface

Em geral, recuperar os dados do Amazon Glacier é um processo de duas etapas: 

1. Inicie um trabalho de recuperação.

1. Depois que o trabalho for concluído, faça download dos bytes de dados. 

Para recuperar um arquivo do Amazon Glacier, você primeiro inicia um trabalho. Depois que o trabalho for concluído, você fará download dos dados. Para obter mais informações sobre recuperações de arquivo, consulte [Recuperação de arquivos do Amazon Glacier](downloading-an-archive-two-steps.md).

O tempo de acesso da solicitação depende da opção de recuperação escolhida por você: expressa, padrão ou em massa. Exceto para os arquivos maiores (mais de 250 MB), os dados acessados usando-se recuperações expressas costumam ser disponibilizados dentro de 1 a 5 minutos. Arquivos recuperados usando-se recuperações padrão normalmente são concluídos entre 3 e 5 horas. As recuperações em massa normalmente são concluídas dentro de 5 a 12 horas. Para obter mais informações sobre as opções de recuperação, consulte as [Perguntas Frequentes do Amazon Glacier](https://aws.amazon.com/glacier/faqs/#Data-retrievals). Para obter mais informações sobre cobranças pela recuperação de dados, consulte a [Página de Detalhes do Amazon Glacier](https://aws.amazon.com/s3/glacier/pricing/).

Os exemplos de código mostrados nos tópicos a seguir iniciam o trabalho, aguardam a conclusão e fazem download dos dados de arquivo. 

**Topics**
+ [Baixe um arquivo de um cofre no Amazon Glacier usando o AWS SDK para Java](getting-started-download-archive-java.md)
+ [Baixe um arquivo de um cofre no Amazon Glacier usando o AWS SDK para .NET](getting-started-download-archive-dotnet.md)

# Baixe um arquivo de um cofre no Amazon Glacier usando o AWS SDK para Java
<a name="getting-started-download-archive-java"></a>

O exemplo de código Java a seguir usa a API de alto nível do AWS SDK para Java para baixar o arquivo que você carregou na etapa anterior. No exemplo de código, observe o seguinte:
+ O exemplo cria uma instância da classe `AmazonGlacierClient`. 
+ O código usa a região Oeste dos EUA (`us-west-2`) de acordo com o local onde você criou o cofre em [Etapa 2: criar um cofre no Amazon Glacier](getting-started-create-vault.md). 
+ O exemplo usa `download` operação API da classe `ArchiveTransferManager` oriundo de API de nível superior do AWS SDK para Java. O exemplo cria um tópico do Amazon Simple Notification Service (Amazon SNS) e uma fila do Amazon Simple Queue Service (Amazon SQS) que está inscrita nesse tópico. Se você criou um usuário administrador AWS Identity and Access Management (IAM) conforme instruído em[Etapa 1: antes de começar com o Amazon Glacier](getting-started-before-you-begin.md), seu usuário tem as permissões IAM necessárias para a criação e o uso do tópico do Amazon SNS e da fila do Amazon SQS.

Para step-by-step obter instruções 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ê deve atualizar o código conforme mostrado com o ID do arquivo que você carregou em [Etapa 3: fazer upload de um arquivo para um cofre no Amazon Glacier](getting-started-upload-archive.md). 

**Example — Baixar um arquivo usando o AWS SDK para Java**  <a name="GS_ExampleDownloadArchiveJava"></a>

```
import java.io.File;
import java.io.IOException;

import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.glacier.AmazonGlacierClient;
import com.amazonaws.services.glacier.transfer.ArchiveTransferManager;
import com.amazonaws.services.sns.AmazonSNSClient;
import com.amazonaws.services.sqs.AmazonSQSClient;

public class AmazonGlacierDownloadArchive_GettingStarted {
    public static String vaultName = "examplevault";
    public static String archiveId = "*** provide archive ID ***";
    public static String downloadFilePath  = "*** provide location to download archive ***";
    
    public static AmazonGlacierClient glacierClient;
    public static AmazonSQSClient sqsClient;
    public static AmazonSNSClient snsClient;
    
    public static void main(String[] args) throws IOException {
        
        
    	ProfileCredentialsProvider credentials = new ProfileCredentialsProvider();
    	
        glacierClient = new AmazonGlacierClient(credentials);        
        sqsClient = new AmazonSQSClient(credentials);
        snsClient = new AmazonSNSClient(credentials);
        
        glacierClient.setEndpoint("glacier.us-west-2.amazonaws.com");
        sqsClient.setEndpoint("sqs.us-west-2.amazonaws.com");
        snsClient.setEndpoint("sns.us-west-2.amazonaws.com");

        try {
            ArchiveTransferManager atm = new ArchiveTransferManager(glacierClient, sqsClient, snsClient);
            
            atm.download(vaultName, archiveId, new File(downloadFilePath));
            
        } catch (Exception e)
        {
            System.err.println(e);
        }
    }
}
```

# Baixe um arquivo de um cofre no Amazon Glacier usando o AWS SDK para .NET
<a name="getting-started-download-archive-dotnet"></a>

O exemplo de código C\$1 a seguir usa a API de alto nível do AWS SDK para .NET para baixar o arquivo que você carregou anteriormente. [Faça upload de um arquivo para um cofre no Amazon Glacier usando o AWS SDK para .NET](getting-started-upload-archive-dotnet.md) No exemplo de código, observe o seguinte:

 
+ O exemplo cria uma instância da classe `ArchiveTransferManager` para o endpoint especificado da região do Amazon Glacier.
+ O exemplo de código usa a Região Oeste dos EUA (Oregon) (`us-west-2`) de acordo com o local onde você previamente criou o cofre. 
+ O exemplo usa a operação `Download` API da classe `ArchiveTransferManager` para baixar seu arquivo. O exemplo cria um tópico do Amazon Simple Notification Service (Amazon SNS) e uma fila do Amazon Simple Queue Service (Amazon SQS) que está inscrita nesse tópico. Se você criou um usuário administrador AWS Identity and Access Management (IAM) conforme instruído em[Etapa 1: antes de começar com o Amazon Glacier](getting-started-before-you-begin.md), seu usuário tem as permissões IAM necessárias para a criação e o uso do tópico do Amazon SNS e da fila do Amazon SQS.
+ Em seguida, o exemplo inicia o trabalho de recuperação do arquivo e sonda a fila em busca do arquivo disponível. Assim que o arquivo estiver disponível, o download começará. Para obter informações sobre tempos de recuperação, consulte [Opções de recuperação de arquivos](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options).

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ê deve atualizar o código conforme mostrado com o ID do arquivo que você carregou em [Etapa 3: fazer upload de um arquivo para um cofre no Amazon Glacier](getting-started-upload-archive.md). 

**Example — Baixe um arquivo usando a API de alto nível do AWS SDK para .NET**  <a name="GS_ExampleDownloadArchiveDotNet"></a>

```
using System;
using Amazon.Glacier;
using Amazon.Glacier.Transfer;
using Amazon.Runtime;

namespace glacier.amazon.com.rproxy.govskope.us.docsamples
{
    class ArchiveDownloadHighLevel_GettingStarted
    {
        static string vaultName = "examplevault";
        static string archiveId = "*** Provide archive ID ***";
        static string downloadFilePath = "*** Provide the file name and path to where to store the download ***";

        public static void Main(string[] args)
        {
            try
            {
                var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2);

                var options = new DownloadOptions();
                options.StreamTransferProgress += ArchiveDownloadHighLevel_GettingStarted.progress;
                // Download an archive.
                Console.WriteLine("Intiating the archive retrieval job and then polling SQS queue for the archive to be available.");
                Console.WriteLine("Once the archive is available, downloading will begin.");
                manager.Download(vaultName, archiveId, downloadFilePath, options);
                Console.WriteLine("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 int currentPercentage = -1;
        static void progress(object sender, StreamTransferProgressArgs args)
        {
            if (args.PercentDone != currentPercentage)
            {
                currentPercentage = args.PercentDone;
                Console.WriteLine("Downloaded {0}%", args.PercentDone);
            }
        }
    }
}
```