Fazer download de um inventário de cofre no Amazon S3 Glacier - Amazon S3 Glacier
Sobre o inventário

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

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

Depois que você fizer upload do primeiro arquivo para o cofre, o Amazon S3 Glacier (S3 Glacier) vai criar e atualizar automaticamente um inventário de cofre 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 cofre 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 (POSTtrabalhos).

    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 trabalho é executada de maneira assíncrona. Quando você inicia um trabalho de recuperação, o S3 Glacier cria um trabalho e retorna um ID de trabalho na resposta. Quando o S3 Glacier conclui o trabalho, você pode receber a saída do trabalho, os bytes do arquivo ou os dados do inventário de 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 (AmazonSNS) no qual o S3 Glacier pode publicar uma notificação após a conclusão do trabalho. Você pode especificar o SNS tópico da Amazon usando os seguintes métodos:

    • Especifique um SNS tópico da Amazon por base de trabalho.

      Ao iniciar um trabalho, você pode, opcionalmente, especificar um tópico da AmazonSNS.

    • 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 Configurar notificações de cofre no Amazon S3 Glacier). O S3 Glacier envia uma mensagem para o SNS tópico 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 SNS tópico da Amazon ao iniciar um trabalho, o S3 Glacier enviará uma mensagem de conclusão do trabalho para os dois tópicos.

    Você pode configurar o SNS tópico para notificá-lo por e-mail ou armazenar a mensagem em um Amazon Simple Queue Service (AmazonSQS) para que seu aplicativo possa pesquisar. 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 trabalho (Trabalho de descrição (GET JobID)) que permite sondar informações desse trabalho. Periodicamente, você pode enviar essa solicitação para obter informações de trabalho. No entanto, usar SNS as notificações da Amazon é a opção recomendada.

nota

As informações que você recebe por meio de SNS notificação são as mesmas que você obtém ao chamar Describe Job.

Tópicos

Sobre o inventário

O S3 Glacier atualiza o 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 S3 Glacier retorna o último inventário gerado, que é um point-in-time instantâneo e não dados em tempo real. Depois que o S3 Glacier criar o primeiro inventário para o cofre, 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 de trabalho de inventário, consulte Corpo da resposta Get Job Output API.