Descarga de un archivo en Amazon S3 Glacier con la AWS CLI

Puede descargar archivos en Amazon S3 Glacier (S3 Glacier) mediante la AWS Command Line Interface (AWS CLI).

(Requisito previo) Configuración de la AWS CLI

1. Descargue y configure la AWS CLI. Para obtener instrucciones, consulte los siguientes temas en la Guía del usuario de AWS Command Line Interface:

   Instalación de la AWS Command Line Interface

   Configuración del AWS Command Line Interface

2. Verifique la configuración de la AWS CLI; para ello, introduzca los siguientes comandos en el símbolo del sistema. Estos comandos no proporcionan las credenciales de forma explícita, por lo que se utilizan las credenciales del perfil predeterminado.

   • Pruebe a usar el comando de ayuda.

     aws help

   • Para obtener una lista de los almacenes de S3 Glacier en la cuenta configurada, use el comando list-vaults. Sustituya 123456789012 por el ID de su Cuenta de AWS.

     aws glacier list-vaults --account-id 123456789012

   • Para ver los datos de la configuración actual de la AWS CLI, use el comando aws configure list.

     aws configure list

Ejemplo: Descarga de un archivo con la AWS CLI

nota

Para descargar sus archivos, debe saber cuáles son sus ID. Con los pasos del 1 al 4 se recuperarán los ID de archivo. Si ya conoce los ID de los archivos que quiere descargar, vaya al paso 5.

1. Utilice el comando initiate-job para comenzar un trabajo de recuperación de inventario. El informe de inventario enumerará sus ID de archivo.

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

   Salida prevista:

   
   {
       "location": "/111122223333/vaults/awsexamplevault/jobs/*** jobid ***", 
       "jobId": "*** jobid ***"
   }
   						

2. Utilice el comando describe-job para comprobar el estado del comando job anterior.

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

   Salida prevista:

   {
       "InventoryRetrievalParameters": {
           "Format": "JSON"
       }, 
       "VaultARN": "*** vault arn ***", 
       "Completed": false, 
       "JobId": "*** jobid ***", 
       "Action": "InventoryRetrieval", 
       "CreationDate": "*** job creation date ***", 
       "StatusCode": "InProgress"
   }
   						

3. Espere a que el trabajo finalice.

   Debe esperar hasta que la salida del trabajo esté lista para que pueda realizar la descarga. Si configuró las notificaciones en el almacén o especificó un tema de Amazon Simple Notification Service (Amazon SNS) al comenzar el trabajo, S3 Glacier envía un mensaje a ese tema cuando complete el trabajo.

   Puede configurar las notificaciones de determinados eventos en el almacén. Para obtener más información, consulte Configuración de las notificaciones de almacén en Amazon S3 Glacier. S3 Glacier envía un mensaje al tema de SNS especificado siempre que se produzca ese evento específico.

4. Cuando haya finalizado, utilice el comando get-job-output para descargar el trabajo de recuperación en el archivo output.json. Este archivo contendrá sus ID de archivo.

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

   Este comando genera un archivo con los siguientes campos.

   
   {
   "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. Utilice el comando initiate-job para iniciar el proceso de recuperación de cada archivo de un almacén. Deberá especificar el parámetro de trabajo como archive-retrieval, tal como se muestra a continuación.

   aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters="{\"Type\":\"archive-retrieval\",\"ArchiveId\":\"*** archiveId ***\"}"

6. Espere a que el trabajo archive-retrieval finalice. Utilice el comando describe-job para comprobar el estado del comando anterior.

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

7. Cuando se complete el trabajo anterior, use el comando get-job-output para descargar su archivo.

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