

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

# Usando o AWS SDKs com o Amazon Glacier
<a name="using-aws-sdk"></a>

AWS permite SDKs que você desenvolva aplicativos para o Amazon Glacier. As bibliotecas de SDKs encapsulam a API do Amazon Glacier subjacente, simplificando as tarefas de programação. Por exemplo, para cada solicitação enviada ao Amazon Glacier, deve ser incluída uma assinatura a fim de autenticar as solicitações. Ao usar as bibliotecas do SDK, você precisa fornecer somente suas credenciais de AWS segurança em seu código, e as bibliotecas computam a assinatura necessária e a incluem na solicitação enviada ao Amazon Glacier. Eles AWS SDKs fornecem bibliotecas que mapeiam para a API REST subjacente e fornecem objetos que você pode usar para criar solicitações e processar respostas com facilidade. 

**Topics**
+ [AWS Bibliotecas do SDK para Java e.NET](#java-.net-sdk-libraries)
+ [Usando o Amazon Glacier com um SDK AWS](sdk-general-information-section.md)
+ [Usando o AWS SDK para Java com o Amazon Glacier](using-aws-sdk-for-java.md)
+ [Como usar o AWS SDK para .NET com o Amazon Glacier](using-aws-sdk-for-dot-net.md)

O AWS Command Line Interface (AWS CLI) é uma ferramenta unificada para gerenciar sua Serviços da AWS, incluindo o Amazon Glacier. Para obter informações sobre como baixar o AWS CLI, consulte [AWS Command Line Interface](https://aws.amazon.com/cli/). Para obter uma lista de comandos da CLI do Amazon Glacier, consulte [Referência de comandos da AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/glacier/index.html). 

## AWS Bibliotecas do SDK para Java e.NET
<a name="java-.net-sdk-libraries"></a>

O AWS SDKs for Java e.NET oferece bibliotecas de wrapper de alto e baixo nível. 

Você pode encontrar exemplos de trabalho com o Amazon Glacier usando o AWS SDK para Java e o AWS SDK para .NET em todo este guia do desenvolvedor. 

### O que é API de nível inferior?
<a name="what-is-low-level-api"></a>

As bibliotecas wrapper de baixo nível são mapeadas de maneira próxima à API REST subjacente ([Referência de API para Amazon Glacier](amazon-glacier-api.md)) compatível com o Amazon Glacier. Para cada operação REST do Amazon Glacier, a API de nível inferior oferece um método correspondente, um objeto de solicitação para que sejam fornecidas informações solicitadas e um objeto de resposta para que você processe a resposta do Amazon Glacier. As bibliotecas wrapper de nível inferior são a implementação mais completa das operações subjacentes do Amazon Glacier. 

Para obter informações sobre essas bibliotecas do SDK, consulte [Usando o AWS SDK para Java com o Amazon Glacier](using-aws-sdk-for-java.md) e [Como usar o AWS SDK para .NET com o Amazon Glacier](using-aws-sdk-for-dot-net.md).

### O que é API de nível superior?
<a name="what-is-high-level-api"></a>

Para simplificar ainda mais o desenvolvimento do aplicativo, essas bibliotecas oferecem uma abstração de nível superior para algumas das operações. Por exemplo: 
+ Fazer upload de um arquivo: para fazer upload de um arquivo usando API de nível inferior, além do nome de arquivo e o nome do cofre onde deseja salvar o arquivo, você precisa fornecer uma soma de verificação (SHA-256 tree hash) da carga útil. No entanto, a API de nível superior computa a soma de verificação para você.
+ Fazer download de um arquivo ou inventário do cofre: para fazer download de um arquivo usando API de nível inferior, você primeiro inicia um trabalho, aguarda a conclusão e obtém a saída do trabalho. Escreva um código adicional para configurar um tópico do Amazon Simple Notiﬁcation Service (Amazon SNS) para receber via Amazon Glacier uma notificação quando o trabalho for concluído. Você também precisa um mecanismo de sondagem para verificar se uma mensagem de conclusão do trabalho foi publicada no tópico. A API de nível superior oferece um método para fazer download de um arquivo que cuida de todas essas etapas. Você especifica somente um ID de arquivo e um caminho de pasta onde deseja salvar os dados obtidos por download. 

Para obter informações sobre essas bibliotecas do SDK, consulte [Usando o AWS SDK para Java com o Amazon Glacier](using-aws-sdk-for-java.md) e [Como usar o AWS SDK para .NET com o Amazon Glacier](using-aws-sdk-for-dot-net.md).

### Quando usar as APIs de nível superior e de nível inferior
<a name="when-to-use-high-low-api"></a>

Em geral, se a API de nível superior oferece métodos dos quais precisa para realizar uma operação, você deverá usá-la em função da simplicidade proporcionada. No entanto, se a API de nível superior não oferece a funcionalidade, você poderá usar a API de nível inferior. Além disso, a API de nível inferior permite o controle granular da operação, como a lógica de nova tentativa em caso de falha. Por exemplo, ao fazer upload de um arquivo, a API de nível superior usa o tamanho do arquivo para determinar se é necessário fazer upload do arquivo em uma única operação ou usar a API de multipart upload. A API também tem uma lógica de nova tentativa integrada em caso de falha no upload. No entanto, o aplicativo pode precisar de controle granular sobre essas decisões, quando você pode usar a API de nível inferior.