Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e a API REST original de 2012.
Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento S3 Glacier no 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 S3 Glacier e Armazenamento de dados de longo prazo usando 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á.
Usando os AWS SDKs com o Amazon S3 Glacier
AWS fornece SDKs para você 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, 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 S3 Glacier. Os AWS SDKs fornecem bibliotecas que são mapeadas para a API REST subjacente e fornecem objetos que você pode usar para criar solicitações e processar respostas com facilidade.
Tópicos
O AWS Command Line Interface (AWS CLI) é uma ferramenta unificada para gerenciar sua Serviços da AWS, incluindo o S3 Glacier. Para obter informações sobre como baixar o AWS CLI, consulte AWS Command Line Interface
AWS Bibliotecas do SDK para Java e.NET
Os AWS SDKs para Java e.NET oferecem bibliotecas de wrapper de alto e baixo nível.
Você pode encontrar exemplos de trabalho com o Amazon S3 Glacier usando o AWS SDK for Java e o AWS SDK for .NET em todo este 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 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 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.
