Trabalhando com Vaults no Amazon S3 Glacier - Amazon S3 Glacier
Operações de vault no S3 Glacier

Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e o original de 2012. REST API

Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento S3 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 Classes de armazenamento S3 Glacier e Armazenamento de dados de longo prazo usando classes de armazenamento S3 Glacier no Guia do usuário do Amazon S3. Essas classes de armazenamento usam o Amazon S3API, estão disponíveis em todas as regiões e podem ser gerenciadas no console do Amazon S3. Eles oferecem recursos como análise de custos de armazenamento, lente de armazenamento, recursos avançados de criptografia opcional e muito mais.

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 Vaults no Amazon S3 Glacier

Cofre é um contêiner para armazenar arquivos. Ao criar um vault, você especifica um nome de vault e a Região da AWS na qual deseja criar o vault. Para obter uma lista das Regiões da AWS compatíveis com o S3 Glacier, consulte Amazon S3 Glacier Endpoints e cotas em AWS Referência Geral .

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

Importante

O S3 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 AWS CLI ou escrever código para fazer solicitações usando a API REST diretamente ou usando os AWS SDKs da AWS.

Para instalar a AWS CLI, consulte AWS Command Line Interface. Para obter mais informações sobre o uso do S3 Glacier com AWS CLI, consulte a AWS CLIReferência do S3 Glacier. Para obter exemplos de como usar AWS CLI para carregar arquivos no S3 Glacier, consulte Usar o S3 Glacier com AWS Command Line Interface.

Tópicos

Operações de vault no S3 Glacier

O S3 Glacier dá suporte a diversas operações de vault. As operações de vault são específicas para Regiões da AWS em particular. Em outras palavras, ao criar um vault, ele é criado em uma Região da AWS específica. Quando você lista vaults, o S3 Glacier retorna a lista de vaults de Região da AWS especificada na solicitação.

Criar e excluir cofres

Um Conta da AWS pode criar até 1.000 vaults por Região da AWS. Para obter uma lista de Regiões da AWS compatíveis com o S3 Glacier, consulte Amazon S3 Glacier endpoints e cotas em AWS Referência Geral.

Você poderá excluir um vault somente se não houver arquivos nele desde que o último inventário foi computado pelo S3 Glacier e se não houver gravações no vault desde o último inventário.

nota

O S3 Glacier prepara um inventário para cada vault periodicamente, a cada 24 horas. Como o inventário talvez não reflita as informações mais recentes, o S3 Glacier garante que o vault esteja realmente vazio verificando se houve alguma operação de gravação desde o último inventário.

Para obter mais informações, consulte Criação de um cofre no Amazon S3 Glacier e Exclusão de um cofre no Amazon S3 Glacier.

Recuperar metadados do cofre

É possível recuperar informações do vault, como a data de criação, o número de arquivos e o tamanho total de todos os arquivos. O S3 Glacier fornece chamadas de API para você recuperar essas informações de um vault específico ou de todos eles em uma determinada Região da AWS na sua conta. Para obter mais informações, consulte Recuperar metadados do cofre no S3 Glacier..

Fazer download de um inventário de cofre

Um Inventário de vault se refere à lista de arquivos no vault. Para cada arquivo na lista, o inventário fornece informações de arquivo, como ID, data de criação e tamanho. O S3 Glacier atualiza o inventário de vault aproximadamente uma vez por dia, começando no primeiro dia de upload para o vault. 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 job, o S3 Glacier vai preparar o inventário para download. Depois que o job for concluído, você poderá fazer download dos dados de inventário.

Dada a natureza assíncrona do job, 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 job individual ou configurar o vault para enviar uma notificação quando ocorrerem eventos de vault específicos.

O S3 Glacier prepara um inventário para cada vault 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 job para um inventário de vault, o S3 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 associando metadados sobre os arquivos cujo upload fez para o S3 Glacier. Em seguida, você talvez ache o inventário de vault útil para reconciliar informações no banco de dados com o inventário de vault.

Para obter mais informações sobre como recuperar um inventário de cofre, consulte Fazer download de um inventário de cofre no Amazon S3 Glacier.

Configurar notificações de cofre

Recuperando qualquer dado do S3 Glacier, como um arquivo de um vault ou um inventário, é um processo de duas etapas. Primeiro, você inicia um job. Depois que o job for concluído, você poderá fazer download da saída. Para saber quando seu job foi concluído, você pode usar as notificações do S3 Glacier. O S3 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 vault e identificar eventos de vault, além do tópico do Amazon SNS a ser notificado quando o evento ocorrer. Sempre que o evento de vault ocorrer, o S3 Glacier envia uma notificação para o tópico do Amazon SNS especificado. Para obter mais informações, consulte Configurar notificações de cofre no Amazon S3 Glacier.