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 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 com suas próprias APIs que armazena dados em cofres e é diferente das classes de armazenamento do 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, a AWS recomenda as classes de armazenamento do Amazon S3 Glacier
Trabalhar com cofres no Amazon Glacier
Cofre é um contêiner para armazenar arquivos. Ao criar um cofre, você especifica um nome de cofre e a Região da AWS na qual deseja criar o cofre. Para obter uma lista das Regiões da AWS compatíveis com o Amazon Glacier, consulte Endpoints e cotas do Amazon Glacier na Referência geral da 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 arquivo, como upload, download ou exclusão, exige que você use a AWS Command Line Interface (AWS CLI) ou escreva um 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 a AWS CLI ou escrever código para fazer solicitações usando a API REST diretamente ou usando os AWS SDKs.
Para instalar a AWS CLI, consulte AWS Command Line Interface
Tópicos
Operações de cofre no Amazon Glacier
O Amazon Glacier dá suporte a diversas 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 da Região da AWS especificada na solicitação.
Criar e excluir cofres
Uma Conta da AWS pode criar até 1.000 cofre por Região da AWS. Para obter uma lista das Regiões da AWS compatíveis com o Amazon Glacier, consulte Endpoints e cotas do Amazon Glacier na Referência geral da AWS.
Você poderá excluir um cofre somente se não houver arquivos nele desde que o último inventário foi computado pelo Amazon Glacier 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 talvez não reflita as informações mais recentes, o Amazon Glacier garante que o cofre esteja realmente vazio verificando se houve alguma operação de gravação desde o último inventário.
Para obter mais informações, consulte Criar um cofre no Amazon Glacier e Excluir 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 de um cofre específico ou de todos os cofres em determinada Região da AWS na conta. Para obter mais informações, consulte Recuperar metadados do cofre 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 de cofre aproximadamente uma vez por dia, começando no primeiro dia de upload para o 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 o 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 de cofre, o Amazon Glacier retorna o último inventário gerado, que é um snapshot point-in-time, 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, suponhamos que você mantenha um banco de dados no lado do cliente que contém metadados associados aos arquivos cujo upload fez para o 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 Fazer download de um inventário de cofre no Amazon Glacier.
Configurar notificações de cofre
Recuperar qualquer dado do Amazon Glacier, como um arquivo de um cofre ou um inventário de cofre, é 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 foi concluído, você pode usar as notificações do Amazon Glacier. O Amazon Glacier envia mensagens de notificação a 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 de cofre ocorrer, o Amazon Glacier enviará uma notificação para o tópico do Amazon SNS especificado. Para obter mais informações, consulte Configurar notificações do cofre no Amazon Glacier.
