Descarga de un archivo en Amazon Glacier con AWS CLI - Amazon Glacier
(Requisito previo) Configuración de la AWS CLIEjemplo: Descarga de un archivo con la AWS CLI

Esta página es solo para los clientes actuales del servicio Amazon Glacier que utilizan Vaults y la API de REST original de 2012.

Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de Amazon Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte las clases de almacenamiento de Amazon Glacier.

Amazon Glacier (servicio original independiente basado en almacenes) ya no aceptará nuevos clientes a partir del 15 de diciembre de 2025, sin que ello afecte a los clientes actuales. Amazon Glacier es un servicio independiente con sus propias API que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No hay que hacer migraciones. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las clases de almacenamiento Amazon S3 Glacier, que ofrecen una experiencia del cliente superior con las API basadas en buckets de S3, Región de AWS disponibilidad total, costos más bajos e AWS integración de servicios. Si desea mejorar las capacidades, considere la posibilidad de migrar a las clases de almacenamiento de Amazon S3 Glacier mediante nuestra AWSGuía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier.

Descarga de un archivo en Amazon Glacier con AWS CLI

Puede descargar archivos en Amazon Glacier (Amazon 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 la AWS Command Line Interface:

    Instalación del AWS Command Line Interface

    Configuración de la 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 Amazon 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\"}"

    Resultado previsto:

    
{
    "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 ***

    Resultado previsto:

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

  3. Esperar 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, Amazon 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 notificaciones de almacenes en Amazon Glacier. Amazon 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