Esta página é somente para clientes atuais do serviço Amazon Glacier que usam Vaults e a API REST original de 2012.
Se você estiver procurando por soluções de armazenamento de arquivos, recomendamos usar as classes de armazenamento Amazon 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 as classes de armazenamento do Amazon Glacier
O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. 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
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
AWS permite SDKs que você desenvolva aplicativos para o Amazon Glacier. As bibliotecas do SDK envolvem a API subjacente do Amazon Glacier, simplificando suas tarefas de programação. Por exemplo, para cada solicitação enviada ao Amazon Glacier, você deve incluir uma assinatura para autenticar suas 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.
Tópicos
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
AWS Bibliotecas do SDK para Java e.NET
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?
As bibliotecas de wrapper de baixo nível mapeiam de perto a API REST subjacente (Referência de API para Amazon Glacier) suportada pelo Amazon Glacier. Para cada operação REST do Amazon Glacier, a API de baixo nível fornece um método correspondente, um objeto de solicitação para que você forneça informações de solicitação e um objeto de resposta para você processar a resposta do Amazon Glacier. As bibliotecas de wrapper de baixo nível 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 e Usando 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. Você precisa escrever um código adicional para configurar um tópico do Amazon Simple Notification Service (Amazon SNS) para que o Amazon Glacier o notifique 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 e Usando 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.
