Se você é novato no Amazon Simple Storage Service (Amazon S3), recomendamos que comece aprendendo mais sobre as classes de armazenamento S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para obter mais informações, consulte Classes de armazenamento S3 Glacier e Classes
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 AWS SDKs com o Amazon S3 Glacier
AWS disponibiliza SDKs para desenvolver aplicativos para o Amazon S3 Glacier. As bibliotecas de SDKs encapsulam o API S3 Glacier subjacente, simplificando as tarefas de programação. Por exemplo, para cada solicitação enviada ao S3 Glacier, deve ser incluída uma assinatura a fim de autenticar as solicitações. Ao usar as bibliotecas do SDK, é preciso fornecer somente as AWS credenciais de segurança no código e as bibliotecas computam a assinatura necessária, além de incluí-la na solicitação enviada ao S3 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 S3 Glacier. Para obter informações sobre como fazer download da AWS CLI, consulte AWS Command Line Interface
AWS bibliotecas de SDKs da AWS 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 S3 Glacier usando AWS SDK for Java e o AWS SDK for .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 ao API REST subjacente (Referência de API para Amazon S3 Glacier) compatível com o S3 Glacier. Para cada operação S3 Glacier REST, o 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 S3 Glacier. As bibliotecas wrapper de nível inferior são a implementação mais completa das operações subjacentes do S3 Glacier.
Para obter informações sobre essas bibliotecas do SDK, consulte Como usar o Amazon S3 Glacier com a AWS SDK for Java e Como usar o AWS SDK for .NET com o Amazon S3 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 vault 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 vault: Para fazer download de um arquivo usando API de nível inferior, você primeiro inicia um job, aguarda a conclusão e obtém a saída do job. Escreva um código adicional para configurar um tópico do Amazon Simple Notification Service (Amazon SNS) para receber via S3 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 Amazon S3 Glacier com a AWS SDK for Java e Como usar o AWS SDK for .NET com o Amazon S3 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.
