Exemplo de como fazer download de um arquivo no Amazon Glacier usando AWS CLI - Amazon S3 Glacier

Se você é novato no Amazon Simple Storage Service (Amazon S3), recomendamos que comece aprendendo mais sobre as classes de armazenamento S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para obter mais informações, consulte Classes de armazenamento S3 Glacier e Classes de armazenamento para arquivamento de objetos no Guia do usuário do Amazon S3.

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

Exemplo de como fazer download de um arquivo no Amazon Glacier usando AWS CLI

Você pode baixar arquivos no Amazon S3 Glacier (S3 Glacier) usando AWS Command Line Interface (AWS CLI).

(Pré-requisito) Configurar a AWS CLI

  1. Faça download e configure a AWS CLI. Para obter instruções, consulte os seguintes tópicos no Manual do usuário do AWS Command Line Interface:

    Instalar o AWS Command Line Interface

    Configurar a AWS Command Line Interface

  2. Verifique a configuração digitando os comandos a seguir no prompt de comando. Esses comandos não fornecem as credenciais explicitamente, de modo que as credenciais do perfil padrão são usadas.

    • Tente usar o comando de ajuda.

      aws help
    • Para obter uma lista dos cofres do S3 Glacier na conta configurada, use o comando. list-vaults Substitua 123456789012 pelo seu ID Conta da AWS.

      aws glacier list-vaults --account-id 123456789012
    • Para obter a configuração atual para AWS CLI, use o comando aws configure list.

      aws configure list

Fazer download de um arquivo no usando AWS CLI

nota

Para baixar seus arquivos, você deve saber seus IDs de arquivo. As etapas 1 a 4 recuperar seus IDs de arquivo. Se você já conhece os IDs de arquivo que deseja baixar, vá para a etapa 5.

  1. Use o comando initiate-job para iniciar um trabalho de recuperação de inventário. O relatório de inventário listará seus IDs de arquivo.

    aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters="{\"Type\":\"inventory-retrieval\"}"

    Saída esperada:

    { "location": "/111122223333/vaults/awsexamplevault/jobs/*** jobid ***", "jobId": "*** jobid ***" }
  2. Use o comando describe-job para verificar o status do trabalho de recuperação anterior.

    aws glacier describe-job --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid ***

    Saída esperada:

    { "InventoryRetrievalParameters": { "Format": "JSON" }, "VaultARN": "*** vault arn ***", "Completed": false, "JobId": "*** jobid ***", "Action": "InventoryRetrieval", "CreationDate": "*** job creation date ***", "StatusCode": "InProgress" }
  3. Aguarde a conclusão do trabalho.

    Você deve aguardar até a saída do trabalho estar pronta para download. Se você definiu uma configuração de notificação no cofre ou especificou um tópico do Amazon Simple Notification Service (Amazon SNS) ao iniciar o trabalho, o S3 Glacier envia uma mensagem para o tópico depois de concluir o trabalho.

    É possível definir a configuração de notificação para eventos específicos no cofre. Para obter mais informações, consulte Configurar notificações de cofre no Amazon S3 Glacier. O S3 Glacier enviará uma mensagem para o tópico do SNS especificado sempre que o evento determinado ocorrer.

  4. Quando estiver concluído, use o comando get-job-output para fazer download do trabalho de recuperação para o arquivo output.json. Esse arquivo conterá seus IDs de arquivo.

    aws glacier get-job-output --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid *** output.json

    Esse comando produz um arquivo com os campos a seguir.

    { "VaultARN":"arn:aws:glacier:region:111122223333:vaults/awsexamplevault", "InventoryDate":"*** job completion date ***", "ArchiveList":[ {"ArchiveId":"*** archiveid ***", "ArchiveDescription":*** archive description (if set) ***, "CreationDate":"*** archive creation date ***", "Size":"*** archive size (in bytes) ***", "SHA256TreeHash":"*** archive hash ***" } {"ArchiveId": ... ]}
  5. Use o comando initiate-job para iniciar o processo de recuperação de cada arquivo a partir de um cofre. Você precisará especificar o parâmetro do trabalho conforme archive-retrieval mostrado abaixo.

    aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters="{\"Type\":\"archive-retrieval\",\"ArchiveId\":\"*** archiveId ***\"}"
  6. Aguarde a conclusão do trabalho archive-retrieval. Use o comando describe-job para verificar o status do trabalho de recuperação anterior.

    aws glacier describe-job --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid ***
  7. Quando o trabalho acima estiver concluído, use o comando get-job-output para baixar seu arquivo.

    aws glacier get-job-output --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid *** output_file_name