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

Si busca soluciones de almacenamiento de archivos, le sugerimos que utilice las clases de almacenamiento S3 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 Clases de almacenamiento de S3 Glacier y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan Amazon S3API, están disponibles en todas las regiones y se pueden gestionar en la consola de Amazon S3. Ofrecen funciones como el análisis de costos de almacenamiento, Storage Lens, funciones avanzadas de cifrado opcionales y más.

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.

Modelo de datos de Amazon S3 Glacier

Entre los componentes principales del modelo de datos de Amazon S3 Glacier se incluyen los almacenes y los archivos. S3 Glacier es un servicio web basado en REST. En el caso de REST, los almacenes y los archivos son los recursos. Además, el modelo de datos de S3 Glacier contiene recursos de configuración de notificaciones y trabajos. Estos recursos complementan a los recursos básicos.

Almacén

En S3 Glacier, un almacén es un contenedor para guardar archivos. Un almacén es similar a un bucket de Amazon S3. Al crear una bóveda, se especifica un nombre y se elige el Región de AWS lugar donde se quiere crear la bóveda.

Cada recurso de almacén tiene una dirección única. El formato general es:

https://region-specific-endpoint/account-id/vaults/vault-name

Por ejemplo, suponga que crea un almacén (examplevault) en la región Oeste de EE. UU. (Oregón) en su cuenta con el ID 111122223333. Se puede hacer referencia a este almacén con el siguiente URI:

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault

Esto es lo que significan los distintos componentes del URI:

Y Cuenta de AWS puede crear bóvedas en cualquier lugar compatible. Región de AWS Para ver una lista de los compatibles Regiones de AWS, consulte. Acceso a Amazon S3 Glacier Dentro de una región, los nombres de los almacenes de cada cuenta deben ser únicos. Y Cuenta de AWS puede crear bóvedas con el mismo nombre en diferentes regiones.

Puede guardar un número ilimitado de archivos en un almacén. En función de las necesidades de su negocio o de la aplicación, puede guardar estos archivos en uno o varios almacenes.

S3 Glacier admite diversas operaciones relacionadas con los almacenes. Las operaciones de los almacenes son específicas de cada región. Por ejemplo, si crea un almacén, debe hacerlo en una región específica. Cuando solicitas una lista de almacenes, la solicitas a una región específica Región de AWS y la lista resultante incluye solo los almacenes creados en esa región específica.

Archivado

Un archivo puede contener cualquier tipo de datos, como fotos, vídeos o documentos. Un archivo es similar a un objeto de Amazon S3 y es la unidad base de almacenamiento de S3 Glacier. Cada archivo de almacenamiento tiene un identificador único y una descripción opcional. Solo puede especificar esta descripción opcional durante la carga de un archivo. S3 Glacier asigna al archivo un identificador, que es único Región de AWS en el que se almacena el archivo.

Cada archivo tiene una dirección única. El formato general es el siguiente:

https://region-specific-endpoint/account-id/vaults/vault-name/archives/archive-id

A continuación, se muestra un URI de ejemplo de un archivo guardado en el almacén examplevault de la región Oeste de EE. UU. (Oregón) en la cuenta 111122223333:

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

Puede guardar un número ilimitado de archivos en un almacén.

Trabajo

Un trabajo de S3 Glacier puede recuperar un archivo u obtener un inventario de un almacén.

La recuperación de archivos e inventarios de almacén (listas de archivos) son operaciones asíncronas en S3 Glacier en las que primero debe iniciarse un trabajo para poder descargar después la salida cuando S3 Glacier finaliza el trabajo.

Para iniciar un trabajo de inventario de almacén, debe proporcionar el nombre de un almacén. Los trabajos de recuperación de archivos requieren el nombre del almacén y el ID del archivo. También puede proporcionar una descripción opcional que ayude a identificar los trabajos.

Los trabajos de recuperación de archivo e inventario de almacén se asocian a un almacén. Un almacén puede tener varios trabajos en curso en cualquier momento. Cuando envía una solicitud de trabajo (inicia un trabajo), S3 Glacier devuelve un ID de trabajo para que pueda hacer un seguimiento de este. Cada tarea se identifica de manera inequívoca con un URI que tiene el formato:

https://region-specific-endpoint/account-id/vaults/vault-name/jobs/job-id

A continuación, se muestra un ejemplo de un trabajo asociado a un almacén examplevault en la región Oeste de EE. UU. (Oregón) en la cuenta 111122223333.

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID

S3 Glacier mantiene cierta información para cada trabajo, como el tipo de trabajo, la descripción, la fecha de creación, la fecha de finalización y el estado del trabajo. Puede obtener información sobre un trabajo específico u obtener una lista de todos los trabajos asociados con un almacén. La lista de los trabajos que S3 Glacier devuelve incluye todos los trabajos en curso y los finalizados recientemente.

Configuración de las notificaciones

Como los trabajos tardan un tiempo en ejecutarse, S3 Glacier cuenta con un mecanismo de notificación para avisarle cuando se completa un trabajo. Puede configurar un almacén para enviar una notificación a un tema de Amazon Simple Notification Service (Amazon SNS) cuando se complete un trabajo. Puede especificar un tema de Amazon SNS para cada almacén en la configuración de las notificaciones.

S3 Glacier almacena la configuración de las notificaciones como documento JSON. A continuación, se muestra un ejemplo de la configuración de las notificaciones de un almacén:

{
   "Topic": "arn:aws:sns:us-west-2:111122223333:mytopic", 
   "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] 
}

La configuración de las notificaciones está asociada al almacén, por lo que solo puede tener una para cada almacén. Cada recurso de configuración de notificaciones se identifica de manera inequívoca mediante un URI con el formato:

https://region-specific-endpoint/account-id/vaults/vault-name/notification-configuration

S3 Glacier dispone de operaciones para establecer, obtener y eliminar una configuración de notificación. Si se elimina una configuración de notificación, no se envían notificaciones cuando la operación de recuperación de datos del almacén se complete.