Como usar os SDKs da AWS com o Amazon Glacier - Amazon Glacier
Bibliotecas de AWS SDKs para Java e .NET

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.

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, 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.

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

Como usar os SDKs da AWS com o Amazon Glacier

A AWS oferece SDKs para você desenvolver 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, é preciso fornecer somente as credenciais de segurança da AWS no código e as bibliotecas computam a assinatura necessária, além de incluí-la na solicitação enviada ao Amazon Glacier. Os AWS SDKs oferecem bibliotecas mapeadas ao API REST subjacente e fornecem objetos que podem ser usados para estruturar facilmente solicitações e processar respostas.

Tópicos

A AWS Command Line Interface (AWS CLI) é uma ferramenta unificada para gerenciar Serviços da AWS, incluindo o Amazon Glacier. Para obter informações sobre como fazer download da AWS CLI, consulte AWS Command Line Interface. Para obter uma lista de comandos da CLI do Amazon Glacier, consulte Referência de comandos da AWS CLI.

Bibliotecas de AWS SDKs para Java e .NET

Os AWS SDKs para Java e .NET oferecem bibliotecas wrapper de níveis superior e inferior.

Encontre exemplos de como trabalhar com o Amazon Glacier usando AWS SDK para Java e AWS SDK para .NET ao longo deste guia do desenvolvedor.

O que é API de nível inferior?

As bibliotecas wrapper de baixo nível são mapeadas de maneira próxima à API REST subjacente (Referência de API para Amazon Glacier) 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 Como usar o AWS SDK para Java com o Amazon Glacier e Como usar o AWS SDK para .NET com o Amazon Glacier.

O que é API de nível superior?

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 Notification 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 Como usar o AWS SDK para Java com o Amazon Glacier e Como usar o AWS SDK para .NET com o Amazon Glacier.

Quando usar as APIs de nível superior e de nível inferior

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.