Baixando um inventário do Vault no Amazon Glacier - Amazon Glacier
Sobre o inventário

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

Baixando um inventário do Vault no Amazon Glacier

Depois de carregar seu primeiro arquivo no seu cofre, o Amazon Glacier (Amazon Glacier) cria automaticamente um inventário do cofre e o atualiza aproximadamente uma vez por dia. Depois que o Amazon Glacier cria o primeiro inventário, normalmente leva meio dia e até um dia para que esse inventário esteja disponível para recuperação. Você pode recuperar um inventário do cofre do Amazon Glacier com o seguinte processo de duas etapas:

  1. Inicie um trabalho de recuperação de inventário usando a operação Initiate Job (trabalhos POST).

    Importante

    Uma política de recuperação de dados pode causar uma falha na solicitação do trabalho de recuperação de inicialização com uma exceção PolicyEnforcedException. Para obter mais informações sobre políticas de recuperação de dados, consulte Políticas de recuperação de dados do Amazon Glacier. Para obter mais informações sobre a exceção PolicyEnforcedException, consulte Respostas de erro.

  2. Após a conclusão do trabalho, faça download dos bytes usando a operação Get Job Output (GET output).

Por exemplo, recuperar um arquivo ou um inventário de cofre exige que você primeiro inicie um trabalho de recuperação. A solicitação de trabalho é executada de maneira assíncrona. Quando você inicia um trabalho de recuperação, o Amazon Glacier cria um trabalho e retorna um ID do trabalho na resposta. Quando o Amazon Glacier conclui o trabalho, você pode obter a saída do trabalho, os bytes de arquivamento ou os dados de inventário do cofre.

O trabalho deverá ser concluído para você obter a saída. Para determinar o status do trabalho, você tem as seguintes opções:

  • Aguarde a notificação de conclusão do trabalho — Você pode especificar um tópico do Amazon Simple Notification Service (Amazon SNS) no qual o Amazon Glacier pode publicar uma notificação após a conclusão do trabalho. Você pode especificar o tópico do Amazon SNS usando os seguintes métodos:

    • Especifique um tópico do Amazon SNS por trabalho.

      Ao iniciar um trabalho, você também pode especificar um tópico do Amazon SNS.

    • Defina a configuração de notificação no cofre.

      Você pode definir a configuração de notificação para eventos específicos no cofre (consulte Configurando notificações do Vault no Amazon Glacier). O Amazon Glacier envia uma mensagem para o tópico do SNS especificado sempre que o evento específico ocorrer.

    Se você tiver uma configuração de notificação definida no cofre e também especificar um tópico do Amazon SNS ao iniciar um trabalho, o Amazon Glacier enviará uma mensagem de conclusão do trabalho para ambos os tópicos.

    Você pode configurar o tópico do SNS para notificá-lo por e-mail ou armazenar a mensagem em um Amazon Simple Queue Service (Amazon SQS) que o aplicativo possa sondar. Quando uma mensagem for exibida na fila, você poderá verificar se o trabalho foi concluído com êxito e, em seguida, fazer download da saída do trabalho.

  • Solicite informações do trabalho de forma explícita — o Amazon Glacier também fornece uma descrição da operação do trabalho (Trabalho de descrição (GET JobID)) que permite que você faça uma pesquisa para obter informações sobre o trabalho. Periodicamente, você pode enviar essa solicitação para obter informações de trabalho. No entanto, usar notificações do Amazon SNS é a opção recomendada.

nota

As informações obtidas por você por meio da notificação do SNS são as mesmas recebidas quando se chama Describe Job.

Tópicos

Sobre o inventário

O Amazon Glacier atualiza um inventário do cofre pelo menos uma vez por dia, começando no dia em que você carrega pela primeira vez um arquivo no cofre. 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. Observe que, depois que o Amazon Glacier cria o primeiro inventário para o cofre, normalmente leva de meio dia a até um dia para que esse inventário esteja disponível para recuperação.

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 associando metadados sobre os arquivos que você carrega no Amazon Glacier. Nesse caso, talvez você ache o inventário de cofre útil para reconciliar informações, conforme necessário, no seu banco de dados com o inventário de cofre real. É possível limitar o número de itens do inventário recuperados filtrando a data de criação do arquivamento ou definindo uma cota. Para obter mais informações sobre como limitar a recuperação do inventário, consulte Recuperação do inventário de intervalo.

O inventário pode ser retornado em dois formatos: valores separados por vírgula (CSV) ou JSON. Você também pode especificar o formato ao iniciar o trabalho de inventário. O formato padrão é JSON. Para obter mais informações sobre os campos de dados retornados em uma saída do trabalho de inventário, consulte Corpo da resposta da API Obter saída de trabalho.