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, 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 AWS nossa orientação de soluções 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á.

Modelo de dados do Amazon Glacier

Os principais componentes do modelo de dados do Amazon Glacier incluem cofres e arquivos. O Amazon Glacier é um serviço web baseado em REST. Em termos de REST, cofres e arquivos são os recursos. Além disso, o modelo de dados do Amazon Glacier inclui recursos de configuração de tarefas e notificações. Esses recursos complementam os recursos básicos.

Cofre

No Amazon Glacier, um cofre é um contêiner para armazenar arquivos. Um cofre é semelhante a um bucket do Amazon S3. Ao criar um cofre, você especifica um nome e escolhe Região da AWS onde deseja criar o cofre.

Cada recurso do cofre tem um endereço exclusivo. A forma geral é:

https://region-specific-endpoint/account-id/vaults/vault-name

Por exemplo, suponha que um cofre (examplevault) seja criado na região Oeste dos EUA (Oregon) em sua conta com o ID 111122223333. Esse cofre pode ser endereçado pelo seguinte URI:

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault

Veja o que significam os vários componentes do URI:

E Conta da AWS pode criar cofres em qualquer um compatível. Região da AWS Para obter uma lista dos compatíveis Regiões da AWS, consulteAcessando o Amazon Glacier. Em uma região, uma conta deve usar nomes de cofre exclusivos. E Conta da AWS pode criar cofres com o mesmo nome em diferentes regiões.

Você pode armazenar um número ilimitado de arquivos em um cofre. Dependendo das necessidades de negócios ou do aplicativo, você pode armazenar esses arquivos em um cofre ou em vários cofres.

O Amazon Glacier oferece suporte a várias operações de cofre. As operações de cofre são específicas da região. Por exemplo, ao criar um cofre, você faz isso em uma região específica. Quando você solicita uma lista de cofres, você a solicita de uma determinada Região da AWS região, e a lista resultante inclui somente cofres criados nessa região específica.

Arquivo

Um arquivo pode conter quaisquer dados, como uma foto, um vídeo ou um documento. Um arquivo é semelhante a um objeto do Amazon S3 e é a unidade base de armazenamento no Amazon Glacier. Cada arquivo tem uma ID exclusiva e uma descrição opcional. Você pode especificar esta descrição opcional somente durante o upload de um arquivo. O Amazon Glacier atribui ao arquivo uma ID, que é exclusiva Região da AWS na qual o arquivo é armazenado.

Cada arquivo tem um endereço exclusivo. O formato geral é o seguinte:

https://region-specific-endpoint/account-id/vaults/vault-name/archives/archive-id

Este é um URI de exemplo de um arquivo armazenado no cofre examplevault da região Oeste dos EUA (Oregon) na conta 111122223333:

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

Você pode armazenar um número ilimitado de arquivos em um cofre.

Trabalho

Um trabalho do Amazon Glacier pode recuperar um arquivo ou obter um inventário de um cofre.

A recuperação de arquivos e inventários de cofres (listas de arquivos) são operações assíncronas no Amazon Glacier, nas quais você primeiro inicia um trabalho e, em seguida, baixa a saída do trabalho após a conclusão do trabalho pelo Amazon Glacier.

Para iniciar um trabalho de inventário de cofre, você fornece um nome de cofre. Os trabalhos de seleção e de recuperação de arquivo exigem o nome do cofre e o ID do arquivo. Você também pode fornecer uma descrição de trabalho opcional para ajudar a identificar os trabalhos.

Os trabalhos de recuperação de arquivo e inventário de cofre estão associados a um cofre. Um cofre pode ter vários trabalhos em andamento a qualquer momento. Quando você envia uma solicitação de trabalho (inicia um trabalho), o Amazon Glacier retorna a você uma ID de trabalho para rastrear o trabalho. Cada trabalho é identificado com exclusividade por um URI da forma:

https://region-specific-endpoint/account-id/vaults/vault-name/jobs/job-id

Veja a seguir um exemplo de um trabalho associado a um cofre examplevault na região Oeste dos EUA (Oregon) na conta 111122223333.

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID

Para cada trabalho, o Amazon Glacier mantém informações, como tipo de trabalho, descrição, data de criação, data de conclusão e status do trabalho. Você pode obter informações sobre um trabalho específico ou uma lista de todos os trabalhos associados a um cofre. A lista de trabalhos que o Amazon Glacier retorna inclui todos os trabalhos em andamento e concluídos recentemente.

Configuração de notificação

Como os trabalhos demoram para serem executados, o Amazon Glacier oferece suporte a um mecanismo de notificação para notificá-lo quando um trabalho for concluído. Você pode configurar um cofre para enviar uma notificação para um tópico do Amazon Simple Notification Service (Amazon SNS) quando um trabalho é concluído. É possível especificar um tópico do SNS por cofre na configuração de notificação.

O Amazon Glacier armazena a configuração da notificação como um documento JSON. Este é um exemplo de configuração de notificação de cofre:

{
   "Topic": "arn:aws:sns:us-west-2:111122223333:mytopic", 
   "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] 
}

As configurações de notificação são associadas a cofres; pode-se ter uma para cada cofre. Cada recurso de configuração de notificação é identificado com exclusividade por um URI da forma:

https://region-specific-endpoint/account-id/vaults/vault-name/notification-configuration

O Amazon Glacier oferece suporte a operações para definir, obter e excluir uma configuração de notificação. Quando se exclui uma configuração de notificação, nenhuma notificação é enviada quando qualquer operação de recuperação de dados no cofre é concluída.