Fazer download de um inventário de vault no Amazon S3 Glacier - Amazon S3 Glacier

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

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 a API do Amazon S3, 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 de segurança, incluindo várias opções de criptografia 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á.

Fazer download de um inventário de vault no Amazon S3 Glacier

Depois que você fizer upload do primeiro arquivo para o vault, o Amazon S3 Glacier vai criar e atualizar automaticamente um inventário de vault uma vez por dia, aproximadamente. Depois que o criar o primeiro inventário, normalmente levará de meio dia a um dia até que esse inventário esteja disponível para recuperação. Você pode recuperar um inventário de vault do S3 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 S3 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 job é executada de maneira assíncrona. Quando você inicia um job de recuperação, o S3 Glacier cria um job e retorna um ID de job como resposta. Quando o S3 Glacier conclui o job, você pode receber a saída do job, os bytes do arquivo ou os dados do inventário de vault.

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

  • Aguardar a notificação de conclusão de um trabalho– Você pode especificar um tópico do Amazon Simple Notification Service (Amazon SNS) no qual o S3 Glacier poderá publicar uma notificação depois que o job for concluído. Você pode especificar o tópico do Amazon SNS usando os seguintes métodos:

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

      Ao iniciar um job, 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 vault (consulte Configurar notificações de cofre no Amazon S3 Glacier). O S3 Glacier envia uma mensagem para o tópico do SNS especificado sempre que o evento específico ocorrer.

    Se você tiver a configuração de notificação definida no vault e também especificar um tópico do Amazon SNS ao iniciar um job, o S3 Glacier enviará uma mensagem de conclusão do job 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.

  • Solicitar informações do trabalho explicitamente: O S3 Glacier também oferece uma descrição da operação do job (Trabalho de descrição (GET JobID)) que permite sondar informações desse job. 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.

Sobre o inventário

O S3 Glacier atualiza um inventário de vault aproximadamente uma vez por dia, começando no dia em que você faz o primeiro upload para o vault. 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 inicia-se 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. Depois que o S3 Glacier criar o primeiro inventário para o vault, normalmente levará de meio dia a um dia até 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, suponhamos que você mantenha um banco de dados no lado do cliente associando metadados sobre os arquivos cujo upload fez para o S3 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.