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á.
Trabalhando com cofres no Amazon Glacier
Cofre é um contêiner para armazenar arquivos. Ao criar um cofre, você especifica o nome do cofre e o nome Região da AWS no qual deseja criar o cofre. Para obter uma lista dos recursos Regiões da AWS suportados pelo Amazon Glacier, consulte endpoints e cotas do Amazon Glacier na Referência geral.AWS
Você pode armazenar um número ilimitado de arquivos em um cofre.
Importante
O Amazon Glacier fornece um console. No entanto, qualquer operação de arquivamento, como upload, download ou exclusão, exige que você use o AWS Command Line Interface (AWS CLI) ou escreva o código. Não há suporte ao console para operações de arquivo. Por exemplo, para fazer upload de dados, como fotos, vídeos e outros documentos, você deve usar o código AWS CLI ou escrever o código para fazer solicitações, usando a API REST diretamente ou usando AWS SDKs o.
Para instalar o AWS CLI, consulte AWS Command Line Interface
Tópicos
Operações de cofre no Amazon Glacier
O Amazon Glacier oferece suporte a várias operações de cofre. As operações de cofre são específicas para Regiões da AWS em particular. Em outras palavras, ao criar um cofre, ele é criado em uma Região da AWS específica. Quando você lista cofres, o Amazon Glacier retorna a lista de cofres que você especificou Região da AWS na solicitação.
Criar e excluir cofres
Um Conta da AWS pode criar até 1.000 cofres por. Região da AWSPara obter uma lista dos recursos Regiões da AWS suportados pelo Amazon Glacier, consulte endpoints e cotas do Amazon Glacier na Referência geral.AWS
Você pode excluir um cofre somente se não houver nenhum arquivo no cofre a partir do último inventário que o Amazon Glacier computou e se não houver gravações no cofre desde o último inventário.
nota
O Amazon Glacier prepara um inventário para cada cofre periodicamente, a cada 24 horas. Como o inventário pode não refletir as informações mais recentes, o Amazon Glacier garante que o cofre esteja realmente vazio ao verificar se houve alguma operação de gravação desde o último inventário do cofre.
Para obter mais informações, consulte Criação de um cofre no Amazon Glacier e Excluindo um cofre no Amazon Glacier.
Recuperar metadados do cofre
Você pode recuperar informações do cofre, como a data de criação do cofre, o número de arquivos no cofre e o tamanho total de todos os arquivos no cofre. O Amazon Glacier fornece chamadas de API para que você recupere essas informações para um cofre específico ou para todos os cofres em um cofre específico da sua conta. Região da AWS Para obter mais informações, consulte Recuperação de metadados do Vault no Amazon Glacier.
Fazer download de um inventário de cofre
Um inventário de cofre se refere à lista de arquivos no cofre. Para cada arquivo na lista, o inventário fornece informações de arquivo, como ID, data de criação e tamanho. O Amazon Glacier atualiza o inventário do cofre uma vez por dia, começando no dia em que o primeiro arquivo é carregado no cofre. Deve haver um inventário de cofre para que você possa fazer download dele.
Fazer download de um inventário de cofre é uma operação assíncrona. Você deve primeiro iniciar um trabalho para fazer download do inventário. Depois de receber a solicitação de trabalho, o Amazon Glacier prepara seu inventário para download. Depois que o trabalho for concluído, você poderá fazer download dos dados de inventário.
Dada a natureza assíncrona do trabalho, você pode usar as notificações do Amazon Simple Notification Service (Amazon SNS) para notificá-lo quando o trabalho for concluído. Você pode especificar um tópico do Amazon SNS para cada solicitação de trabalho individual ou configurar o cofre para enviar uma notificação quando ocorrerem eventos de cofre específicos.
O Amazon Glacier prepara um inventário para cada cofre periodicamente, a cada 24 horas. Se não houver adições ou exclusões de arquivo no cofre desde o último inventário, a data do inventário não será atualizada.
Quando você inicia um trabalho para um inventário do cofre, o Amazon Glacier retorna o último inventário gerado, que é point-in-time um instantâneo e não dados em tempo real. Talvez você não ache útil recuperar um inventário de cofre para cada upload de arquivo. No entanto, suponha que você mantenha um banco de dados no lado do cliente que contém metadados associados aos arquivos que você carrega no Amazon Glacier. Em seguida, você talvez ache o inventário de cofre útil para reconciliar informações no banco de dados com o inventário de cofre.
Para obter mais informações sobre como recuperar um inventário de cofre, consulte Baixando um inventário do Vault no Amazon Glacier.
Configurar notificações de cofre
Recuperar qualquer coisa do Amazon Glacier, como um arquivo de um cofre ou um inventário de cofres, é um processo de duas etapas. Primeiro, você inicia um trabalho. Depois que o trabalho for concluído, você poderá fazer download da saída. Para saber quando seu trabalho estiver concluído, você pode usar as notificações do Amazon Glacier. O Amazon Glacier envia mensagens de notificação para um tópico do Amazon Simple Notification Service (Amazon SNS) fornecido por você.
Você pode configurar notificações em um cofre e identificar eventos de cofre, além do tópico do Amazon SNS a ser notificado quando o evento ocorrer. Sempre que o evento do cofre ocorre, o Amazon Glacier envia uma notificação para o tópico especificado do Amazon SNS. Para obter mais informações, consulte Configurando notificações do Vault no Amazon Glacier.
