Descarga de un inventario de Vault en Amazon Glacier - Amazon Glacier
Acerca del inventario

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

Si busca soluciones de almacenamiento de archivos, le recomendamos 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 bóveda) 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 propio APIs 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 se requiere ninguna migración. 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 de cliente superior con S3 basada en cubos APIs, 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 Guía de AWS soluciones para transferir datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Descarga de un inventario de Vault en Amazon Glacier

Tras subir el primer archivo a su almacén, Amazon Glacier (Amazon Glacier) crea automáticamente un inventario del almacén y, a continuación, lo actualiza aproximadamente una vez al día. Una vez que Amazon Glacier crea el primer inventario, el inventario suele tardar medio día y hasta un día en estar disponible para su recuperación. Puede recuperar un inventario de almacenes de Amazon Glacier mediante el siguiente proceso de dos pasos:

  1. Inicie un trabajo de recuperación de inventario utilizando la operación Inicialización de trabajos (POST trabajos).

    importante

    Si se utiliza una política de recuperación de datos, puede producirse una excepción PolicyEnforcedException en la solicitud de inicio del trabajo de recuperación. Para obtener más información sobre las políticas de recuperación de datos, consulte Políticas de recuperación de datos de Amazon Glacier. Para obtener más información sobre la excepción PolicyEnforcedException, consulte Respuestas de error.

  2. Una vez completado el trabajo, descargue los bytes utilizando la operación Obtención de la salida del trabajo (GET output).

Por ejemplo, para poder recuperar un archivo o un inventario de almacén, primero es necesario iniciar un trabajo de recuperación. La solicitud del trabajo se ejecuta de forma asincrónica. Al iniciar un trabajo de recuperación, Amazon Glacier crea un trabajo y devuelve un identificador de trabajo en la respuesta. Cuando Amazon Glacier complete el trabajo, podrá obtener el resultado del trabajo, los bytes de archivo o los datos del inventario del almacén.

El trabajo debe completarse antes de poder obtener la salida. Para determinar el estado del trabajo, cuenta con las siguientes opciones:

  • Espere la notificación de finalización del trabajo: puede especificar un tema del Amazon Simple Notification Service (Amazon SNS) en el que Amazon Glacier pueda publicar una notificación una vez que se haya completado el trabajo. Para especificar un tema de Amazon SNS, puede utilizar los siguientes métodos:

    • Puede especificar un tema de Amazon SNS en cada trabajo.

      Cuando inicie un trabajo, si lo desea, puede especificar un tema de Amazon SNS.

    • Puede configurar las notificaciones en el almacén.

      Puede configurar las notificaciones para determinados eventos en el almacén (consulte Configuración de las notificaciones de Vault en Amazon Glacier). Amazon Glacier envía un mensaje al tema de SNS especificado cada vez que se produce el evento específico.

    Si ha establecido una configuración de notificaciones en el almacén y también especifica un tema de Amazon SNS al iniciar un trabajo, Amazon Glacier envía un mensaje de finalización del trabajo a ambos temas.

    Puede configurar el tema de SNS para que le envíe las notificaciones a través del correo electrónico o almacenar el mensaje en una instancia de Amazon Simple Queue Service (Amazon SQS) que la aplicación puede sondear. Cuando aparece un mensaje en la cola, puede comprobar si el trabajo se ha completado correctamente y, a continuación, descargar la salida del trabajo.

  • Solicite información sobre el trabajo de forma explícita: Amazon Glacier también proporciona una descripción de la operación del trabajo (Descripción del trabajo (GET JobID)) que le permite realizar sondeos para obtener información sobre el trabajo. Puede enviar periódicamente esta solicitud para obtener información sobre el trabajo. No obstante, la opción recomendada es utilizar las notificaciones de Amazon SNS.

nota

La información que se obtiene través de las notificaciones de SNS es la misma que se obtiene llamando a Describe Job.

Temas

Acerca del inventario

Amazon Glacier actualiza el inventario de un almacén al menos una vez al día, a partir del día en que se carga un archivo al almacén por primera vez. Si no se han agregando ni eliminado archivos en el almacén desde el último inventario, la fecha del inventario no se actualiza. Al iniciar un trabajo para el inventario de un almacén, Amazon Glacier devuelve el último inventario que generó, que es una point-in-time instantánea y no datos en tiempo real. Tenga en cuenta que, una vez que Amazon Glacier crea el primer inventario para la bóveda, el inventario suele tardar medio día y hasta un día en estar disponible para su recuperación.

Es posible que no le parezca útil recuperar un inventario del almacén cada vez que carga un archivo. Sin embargo, supongamos que mantiene una base de datos en el lado del cliente que asocia metadatos sobre los archivos que carga en Amazon Glacier. En ese caso, el inventario del almacén podría resultarle útil para, en función de sus necesidades, conciliar la información de la base de datos con el inventario del almacén real. Puede limitar el número de elementos del inventario que se van a recuperar utilizando como filtro la fecha de creación del archivo o definiendo una cuota. Para obtener más información sobre la limitación de la recuperación de inventario, consulte Recuperación del inventario por intervalos.

El inventario se puede devolver con dos formatos: valores separados por comas (CSV) o JSON. Si lo desea, puede especificar el formato al iniciar el trabajo de inventario. El formato predeterminado es JSON. Para obtener más información acerca de los campos de datos que se devuelven en la salida de un trabajo de inventario, consulte Cuerpo de respuesta en la API Get Job Output (Obtener salida de trabajo).