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

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 da notificação. 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, é especificado um nome e escolhida uma 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 a Conta da AWS pode criar cofres em qualquer Região da AWS compatível. Para ver uma lista dos Regiões da AWS compatíveis, consulte Acessar o Amazon Glacier . Em uma região, uma conta deve usar nomes de cofre exclusivos. A Conta da AWS pode criar cofres de mesmo nome em regiões diferentes.

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 dá suporte a diversas 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. Ao solicitar uma lista de cofres, ela vem especificamente da Região da AWS, e a lista resultante inclui somente os cofres criados nessa região.

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 básica 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 um ID, que é exclusivo na Região da AWS onde tal arquivo está 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 ser iniciado para recuperar um arquivo ou obter um inventário de um cofre.

Recuperar um arquivo e um inventário de cofre (lista de arquivos) são operações assíncronas no Glacier nas quais deve-se primeiro iniciar um trabalho e, então, fazer download da saída do trabalho depois que Amazon Glacier concluir o trabalho.

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 envia-se uma solicitação de trabalho (iniciar um trabalho), o Amazon Glacier retorna um ID do trabalho para rastreá-lo. 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 retornados pelo Amazon Glacier inclui todos os trabalhos em andamento e concluídos recentemente.

Configuração de notificação

Como os trabalhos demoram para serem concluídos, o Amazon Glacier dá 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 de 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 dá 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.