

# Trabajar con objetos archivados
<a name="archived-objects"></a>

Para reducir los costos de almacenamiento de los objetos a los que se accede con poca frecuencia, puede *archivar* dichos objetos. Cuando archiva un objeto, se traslada a un almacenamiento de bajo costo, lo que significa que no puede acceder a él en tiempo real. 

Aunque los objetos archivados no son accesibles en tiempo real, puede restaurarlos en minutos u horas, según la clase de almacenamiento. Puede restaurar un objeto archivado mediante la consola de Amazon S3, Operaciones por lotes de S3, la API de REST, los SDK de AWS y la AWS Command Line Interface (AWS CLI). Para obtener instrucciones, consulte [Restauración de un objeto archivado](restoring-objects.md).

Los objetos de Amazon S3 de las siguientes clases o niveles de almacenamiento se archivan y no son accesibles en tiempo real: 
+ La clase de almacenamiento S3 Glacier Flexible Retrieval
+ La clase de almacenamiento S3 Glacier Deep Archive
+ La capa de acceso de archivo de S3 Intelligent-Tiering
+ El nivel S3 Intelligent-Tiering Deep Archive Access

Para restaurar los objetos archivados, se debe hacer lo siguiente:
+ Para los objetos de las clases de almacenamiento S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive, se debe iniciar una solicitud de restauración y esperar hasta que esté disponible una copia temporal del objeto. Cuando se crea una copia temporal del objeto restaurado, la clase de almacenamiento del objeto sigue siendo la misma. (Una solicitud de operación de API [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html) o [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html) devuelve S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive como clase de almacenamiento). 
+ En el caso de los objetos de las capas de acceso de archivo o archivo profundo de S3 Intelligent-Tiering, se debe iniciar una solicitud de restauración y esperar hasta que el objeto se mueva a la capa de acceso frecuente. 

Para obtener más información acerca de cómo se comparan todas las clases de almacenamiento de Amazon S3, consulte [Descripción y administración de clases de almacenamiento de Amazon S3](storage-class-intro.md). Para obtener más información acerca de S3 Intelligent-Tiering, consulte [Cómo funciona S3 Intelligent-Tiering](intelligent-tiering-overview.md).

El tiempo que tarda un trabajo de restauración en finalizar depende de la clase de almacenamiento de archivo o el nivel de almacenamiento que utilice y la opción de recuperación que especifique: Acelerada (solo disponible para S3 Glacier Flexible Retrieval y Acceso a archivos de S3 Intelligent-Tiering), Estándar o En bloque. Para obtener más información, consulte [Descripción de las opciones de recuperación de archivos](restoring-objects-retrieval-options.md).

Puede recibir una notificación cuando se haya completado la restauración mediante las notificaciones de eventos de Amazon S3. Para obtener más información, consulte [Notificaciones de eventos de Amazon S3](EventNotifications.md).

## Restauración de objetos desde Amazon Glacier
<a name="archived-objects-glacier"></a>

Cuando utiliza S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive, Amazon S3 restaura una copia temporal del objeto solo durante la duración especificada. Después, elimina la copia del objeto restaurada. Puede modificar el periodo de vencimiento de una copia restaurada mediante la reemisión de una solicitud de restauración. En este caso, Amazon S3 actualiza el periodo de vencimiento en relación con el momento actual. 

**nota**  
Cuando restaura un archivo archivado desde S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive, paga el objeto archivado y la c‎opia que restauró de manera temporal. Para obtener información acerca de los precios, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).

Amazon S3 calcula la hora de vencimiento de la copia del objeto restaurada agregando el número de días especificados en la solicitud de restauración a la hora en que la restauración solicitada termina. Amazon S3 después redondea el tiempo resultante a la medianoche del día siguiente en hora universal coordinada (UTC). Por ejemplo, supongamos que el 15 de octubre de 2012 a las 10:30 UTC se crea una copia restaurada de un objeto y el periodo de restauración se fija en 3 días. En este caso, la copia restaurada tiene como fecha de vencimiento el 19 de octubre de 2012 a las 00:00 UTC, momento en el que Amazon S3 elimina la copia del objeto. 

## Restauración de objetos desde S3 Intelligent-Tiering
<a name="archived-objects-int"></a>

Cuando restaura un objeto desde el nivel Acceso a archivos de S3 Intelligent-Tiering o Acceso a archivos profundo de S3 Intelligent-Tiering, el objeto vuelve a entrar en el nivel Acceso frecuente de S3 Intelligent-Tiering. Si no se accede al objeto después de 30 días consecutivos, se mueve automáticamente al nivel de acceso poco frecuente. Después de un mínimo de 90 días consecutivos sin acceso, el objeto pasa a la capa de acceso de archivo de S3 Intelligent-Tiering. Si no se accede al objeto después de 180 días consecutivos, el objeto se mueve al nivel de acceso de archivo profundo.

**nota**  
A diferencia de las clases de almacenamiento S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive, las solicitudes de restauración para objetos de S3 Intelligent-Tiering no aceptan el valor `Days`. 

## Uso de operaciones por lotes de S3 con solicitudes de restauración
<a name="using-batch-ops-with-restore-requests"></a>

Para restaurar más de un objeto de Amazon S3 con una sola solicitud, puede utilizar Operaciones por lotes de S3. Proporcione a Operaciones por lotes de S3 una lista de objetos en los que operar. Operaciones por lotes de S3 llama a la operación de la API respectiva para realizar la operación especificada. Un solo trabajo de operaciones por lotes puede realizar la operación especificada en miles de millones de objetos con exabytes de datos. 

**Topics**
+ [Restauración de objetos desde Amazon Glacier](#archived-objects-glacier)
+ [Restauración de objetos desde S3 Intelligent-Tiering](#archived-objects-int)
+ [Uso de operaciones por lotes de S3 con solicitudes de restauración](#using-batch-ops-with-restore-requests)
+ [Descripción de las opciones de recuperación de archivos](restoring-objects-retrieval-options.md)
+ [Restauración de un objeto archivado](restoring-objects.md)

# Descripción de las opciones de recuperación de archivos
<a name="restoring-objects-retrieval-options"></a>

Amazon S3 cuenta con tres clases de almacenamiento de archivo: S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Si bien los objetos almacenados en la clase de almacenamiento S3 Glacier Instant Retrieval están disponibles de inmediato mediante `GET`, para acceder a los datos almacenados en las clases de almacenamiento S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive, primero debe recuperar los datos mediante la API de REST [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html). La restauración de conjuntos de datos compuestos por decenas de millones de objetos o cientos de terabytes de datos podría llevar más tiempo de lo habitual y requerir medidas especiales. Para obtener más información, consulte [Restauración de conjuntos de datos de gran tamaño](#restoring-objects-large-datasets).

Puede elegir entre tres opciones de acceso para recuperar sus objetos archivados, en función de la velocidad de recuperación que desee: urgente, estándar y por lotes.
+ **Recuperación rápida**: acceda de manera rápida a los datos que se almacenan en la clase de almacenamiento S3 Glacier Flexible Retrieval o en el nivel S3 Intelligent-Tiering Archive Access. Puede utilizar esta opción para solicitudes urgentes puntuales de hasta cientos de objetos. Los objetos de menos de 250 megabytes suelen estar disponibles en un plazo de entre 1 y 5 minutos, mientras que los objetos de 250 megabytes o más se recuperan normalmente con un rendimiento de recuperación de hasta 300 megabytes por segundo. Además, tiene la opción de adquirir capacidad asignada para recuperaciones rápidas. La capacidad aprovisionada garantiza que la capacidad de recuperación rápida esté disponible cuando la necesite. Para obtener más información, consulte [Capacidad aprovisionada](#restoring-objects-expedited-capacity).
**nota**  
Las recuperaciones aceleradas son una característica premium que se cobra a la tarifa de la solicitud acelerada y de recuperación. Para obtener información acerca de los precios de Amazon S3, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).
+ **Recuperación estándar**: acceda a sus datos en varias horas. Estándar es la opción predeterminada para las solicitudes que no especifican la opción de recuperación. Las recuperaciones estándar generalmente finalizan en un plazo de 3 a 5 horas para la clase de almacenamiento S3 Glacier Flexible Retrieval o en el nivel S3 Intelligent-Tiering Archive Access. Las recuperaciones estándar suelen finalizar en un plazo de 12 horas para la clase de almacenamiento S3 Glacier Deep Archive o en el nivel S3 Intelligent-Tiering Deep Archive Access. Las recuperaciones estándar son gratuitas para los objetos almacenados en la clase de almacenamiento S3 Intelligent-Tiering.
**nota**  
Para objetos almacenados en la clase de almacenamiento S3 Glacier Flexible Retrieval o en nivel S3 Intelligent-Tiering Archive Access, las recuperaciones estándar iniciadas mediante el uso de la operación de restauración de Operaciones por lotes de S3 suelen comenzar en cuestión de minutos y finalizar en un plazo de 3 a 5 horas con un rendimiento de hasta 1-2 petabytes al día.
En el caso de los objetos de la clase de almacenamiento S3 Glacier Deep Archive o del nivel S3 Intelligent-Tiering Deep Archive Access, las recuperaciones estándar iniciadas mediante operaciones por lotes suelen completarse en un plazo de 9 horas, con un rendimiento de hasta 1-2 petabytes al día.
+ **Recuperación en bloque**: acceda a los datos mediante la opción de recuperación menos costosa en clases de almacenamiento S3 Glacier. Con las recuperaciones en bloque, puede recuperar grandes cantidades de datos a un coste reducido. Para los objetos que se almacenan en la clase de almacenamiento S3 Glacier Flexible Retrieval o en el nivel S3 Intelligent-Tiering Archive Access, las recuperaciones masivas suelen finalizar en un plazo de 5 a 12 horas. Para los objetos almacenados en la clase de almacenamiento S3 Glacier Deep Archive o en el nivel S3 Intelligent-Tiering Deep Archive Access, estas recuperaciones suelen finalizar en un plazo de 48 horas. Las recuperaciones masivas son gratuitas para los objetos que se almacenan en las clases de almacenamiento S3 Glacier Flexible Retrieval o S3 Intelligent-Tiering.

En la tabla siguiente se resumen las opciones de recuperación de archivos. Para obtener información acerca de los precios, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).


| Clase o nivel de almacenamiento | Rápida | Estándar (con Operaciones por lotes) | Estándar (sin Operaciones por lotes) | En bloque | 
| --- | --- | --- | --- | --- | 
|  S3 Glacier Flexible Retrieval o S3 Intelligent-Tiering Archive Access  |  Entre 1 y 5 minutos  |  minutos a 5 horas  |  Entre tres y cinco horas  |  Entre cinco y 12 horas  | 
|  Acceso a S3 Glacier Deep Archive o S3 Intelligent-Tiering Deep  |  No disponible  |  Entre 9 y 12 horas  |  En menos de 12 horas  |  En menos de 48 horas  | 

Para realizar una recuperación `Expedited`, `Standard` o `Bulk`, establezca el elemento de solicitud `Tier` en la solicitud de operación de la API de REST [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html) en la opción que desee, o el equivalente en la AWS Command Line Interface (AWS CLI) o los AWS SDK. Si ha adquirido capacidad aprovisionada, todas las recuperaciones rápidas se realizarán automáticamente con su capacidad aprovisionada. 

## Restauración de conjuntos de datos de gran tamaño
<a name="restoring-objects-large-datasets"></a>

La restauración de conjuntos de datos compuestos por decenas de millones de objetos o cientos de terabytes de datos podría llevar más tiempo del habitual en cualquier nivel de recuperación, debido a los límites de recuperación.

Cuando inicie solicitudes de recuperación de objetos almacenados en las clases de almacenamiento S3 Glacier Flexible Retrieval, S3 Glacier Deep Archive o S3 Intelligent-Tiering, se le aplicará un límite de solicitudes de recuperación para su Cuenta de AWS. S3 Glacier admite solicitudes de restauración a una velocidad de hasta 1000 transacciones por segundo. Si se supera esta tasa, las solicitudes válidas se limitan o rechazan y Amazon S3 devuelve un error `ThrottlingException`. Puede utilizar las Operaciones por lotes de S3 para recuperar numerosos objetos con una sola solicitud, lo que permite aprovechar al máximo el límite de solicitudes de recuperación disponible en su cuenta. Para obtener más información, consulte [Realización de operaciones de objetos de forma masiva con Operaciones por lotes](batch-ops.md).

Una vez iniciadas las solicitudes de restauración, S3 Glacier permite restaurar grandes conjuntos de datos con un rendimiento de hasta 1-2 petabytes al día por cuenta de cliente. Independientemente de la opción de recuperación elegida, los objetos de más de 5 terabytes tardarán más en restaurarse, con un rendimiento de recuperación de hasta 300 megabytes por segundo. Por ejemplo, la recuperación de un objeto de S3 Glacier Flexible Retrieval de 50 terabytes podría tardar hasta 48 horas en completarse. Si necesita ampliar los límites de restauración, puede ponerse en contacto con AWS Support.

## Capacidad aprovisionada
<a name="restoring-objects-expedited-capacity"></a>

La capacidad aprovisionada garantiza que la capacidad de recuperación para las recuperaciones rápidas de S3 Glacier Flexible Retrieval esté disponible cuando la necesite. Cada unidad de capacidad permite que se puedan realizar al menos tres recuperaciones rápidas cada 5 minutos y proporciona hasta 300 megabytes por segundo de rendimiento de recuperación.

Sin la capacidad aprovisionada, puede que no se acepten las recuperaciones rápidas durante los períodos de alta demanda. Si desea un acceso rápido y fiable a una mayor cantidad de sus datos, considere la posibilidad de utilizar la clase de almacenamiento [S3 Glacier Instant Retrieval](https://aws.amazon.com/s3/storage-classes/glacier/instant-retrieval/).

Las unidades de capacidad aprovisionada se asignan a una Cuenta de AWS. Por lo tanto, el solicitante de la recuperación acelerada de datos debe comprar la unidad de capacidad aprovisionada, no el propietario del bucket.

Puede adquirir capacidad aprovisionada con la consola de Amazon S3, la consola de Amazon Glacier, la operación de la API de REST [Comprar capacidad aprovisionada](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-PurchaseProvisionedCapacity.html), los AWS SDK o la AWS CLI. Para obtener información acerca de los precios de la capacidad aprovisionada, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).

# Restauración de un objeto archivado
<a name="restoring-objects"></a>

Los objetos de Amazon S3 de las siguientes clases o niveles de almacenamiento se archivan y no son accesibles en tiempo real: 
+ La clase de almacenamiento S3 Glacier Flexible Retrieval
+ La clase de almacenamiento S3 Glacier Deep Archive
+ La capa de acceso de archivo de S3 Intelligent-Tiering
+ El nivel S3 Intelligent-Tiering Deep Archive Access

Los objetos de Amazon S3 almacenados en las clases de almacenamiento S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive no son accesibles inmediatamente. Para tener acceso a un objeto en estas clases de almacenamiento, se debe restaurar una copia temporal del objeto en el bucket de S3 correspondiente durante un periodo especificado (número de días). Si desea obtener una copia permanente del objeto, restaure el objeto y, a continuación, cree una copia del objeto en su bucket de Amazon S3. La consola de Amazon S3 no admite la copia de objetos restaurados. Para este tipo de operación de copia, utilice la AWS Command Line Interface (AWS CLI), los SDK de AWS o la API de REST. A menos que haga una copia y cambie su clase de almacenamiento, el objeto seguirá almacenándose en las clases de almacenamiento S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Para obtener información sobre el uso de estas clases de almacenamiento, consulte [Clases de almacenamiento para objetos a los que se accede con poca frecuencia](storage-class-intro.md#sc-glacier).

Para acceder a objetos de los niveles Acceso a archivos o Acceso a archivos profundo de S3 Intelligent-Tiering, se debe iniciar una solicitud de restauración y esperar hasta que el objeto se mueva al nivel Acceso frecuente. Cuando se restaura desde las capas de acceso de archivo de o acceso profundo, el objeto vuelve a pasar a la capa de acceso frecuente. Para obtener información sobre el uso de estas clases de almacenamiento, consulte [Clase de almacenamiento para optimizar automáticamente los datos con patrones de acceso cambiantes o desconocidos](storage-class-intro.md#sc-dynamic-data-access).

Para obtener información general acerca de los objetos archivados, consulte [Trabajar con objetos archivados](archived-objects.md).

**nota**  
Cuando restaura un archivo archivado desde las clases de almacenamiento S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive, paga el objeto archivado y la c‎opia que restauró de manera temporal. 
Al restaurar un objeto desde S3 Intelligent-Tiering, las recuperaciones estándar o en bloque no conllevan gastos de recuperación. 
Las solicitudes de restauración posteriores llamadas en objetos archivados que ya se han restaurado se facturarán como una solicitud `GET`. Para obtener información acerca de los precios, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/). 

## Restauración de un objeto archivado
<a name="restore-archived-objects"></a>

Puede restaurar un objeto archivado mediante la consola de Amazon S3, la API de REST de Amazon S3, los SDK de AWS, la AWS Command Line Interface (AWS CLI) u Operaciones por lotes de S3. 

### Uso de la consola de S3
<a name="restoring-objects-console"></a>

**Restaurar objetos mediante la consola de Amazon S3**  
Utilice el siguiente procedimiento para Restaurar un objeto que se ha archivado en las clases de almacenamiento S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive, o en los niveles de almacenamiento Acceso a archivos o Acceso a archivos profundo de S3 Intelligent-Tiering.

**Para restaurar un objeto archivado**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets de uso general**.

1. En la lista de buckets, seleccione el nombre del bucket que contiene los objetos que desea restaurar.

1. En la lista **Name (Nombre)**, seleccione el objeto o los objetos que desea restaurar, elija **Actions (Acciones)** y, luego, **Initiate restore (Iniciar restauración)**.

1. Si va a restaurar desde S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive, introduzca el número de días que desea que sus datos archivados estén accesibles en el cuadro **Número de días que la copia restaurada está disponible**. 

1. En **Nivel de recuperación**, realice una de las acciones siguientes:
   + Seleccione **Recuperación en bloque** o **Recuperación estándar** y, a continuación, seleccione **Iniciar restauración**. 
   + Elija **Expedited retrieval** (Recuperación urgente) (disponible solo para S3 Glacier Flexible Retrieval o S3 Intelligent-Tiering Archive Access). Si va a restaurar un objeto en S3 Glacier Flexible Retrieval, puede elegir si desea adquirir capacidad aprovisionada para su recuperación rápida. Si desea adquirir capacidad aprovisionada, continúe con el siguiente paso. En caso contrario, elija **Iniciar restauración**.
**nota**  
Los objetos de los niveles Acceso a archivos y Acceso a archivos profundo de S3 Intelligent-Tiering se restauran automáticamente en el nivel Acceso frecuente.

1. (Opcional) Si va a restaurar un objeto en S3 Glacier Flexible Retrieval y ha elegido **Recuperación rápida**, puede elegir si desea adquirir capacidad aprovisionada. La capacidad aprovisionada solo está disponible para objetos en S3 Glacier Flexible Retrieval. Si ya tiene capacidad aprovisionada, seleccione **Iniciar restauración** para comenzar una recuperación aprovisionada. 

   Si tiene capacidad aprovisionada, todas sus recuperaciones rápidas funcionan con la capacidad aprovisionada. Para obtener más información, consulte [Capacidad aprovisionada](restoring-objects-retrieval-options.md#restoring-objects-expedited-capacity). 
   + Si no tiene capacidad aprovisionada y no desea comprarla, seleccione **Iniciar restauración**. 
   + Si no tiene capacidad aprovisionada, pero quiere comprar unidades de capacidad aprovisionada (PCU), elija **Adquirir PCU**. En el cuadro de diálogo **Adquirir PCU**, elija cuántas PCU desea comprar, confirme la compra y, a continuación, elija **Adquirir PCU**. Cuando recibe el mensaje **Compra realizada correctamente**, seleccione **Iniciar restauración** para comenzar la recuperación aprovisionada.

### Uso de AWS CLI
<a name="restoring-objects-cli"></a>

**Restaurar objetos desde S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive**  
El siguiente ejemplo utiliza el comando `restore-object` para restaurar el objeto *`dir1/example.obj`* en el bucket `amzn-s3-demo-bucket` durante 25 días.

```
aws s3api restore-object --bucket amzn-s3-demo-bucket --key dir1/example.obj --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Standard"}}'
```

Si la sintaxis JSON utilizada en el ejemplo produce un error en un cliente de Windows, reemplace la solicitud de restauración por la siguiente sintaxis:

```
--restore-request Days=25,GlacierJobParameters={"Tier"="Standard"}
```

**Restaurar objetos desde Acceso a archivos y Acceso a archivos profundo de S3 Intelligent-Tiering**  
El siguiente ejemplo utiliza el comando `restore-object` para restaurar el objeto *`dir1/example.obj`* del bucket `amzn-s3-demo-bucket` en el nivel Acceso frecuente.

```
aws s3api restore-object --bucket amzn-s3-demo-bucket --key dir1/example.obj --restore-request '{}'
```

**nota**  
A diferencia de las clases de almacenamiento S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive, las solicitudes de restauración para objetos de S3 Intelligent-Tiering no aceptan el valor `Days`.

**Monitorear el estado de restauración**  
Para monitorear el estado de la solicitud `restore-object`, use el comando `head-object` siguiente:

```
aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj
```

Para obtener más información, consulte [https://docs.aws.amazon.com//cli/latest/reference/s3api/restore-object.html](https://docs.aws.amazon.com//cli/latest/reference/s3api/restore-object.html) en la *Referencia de comandos de la AWS CLI*.

### Uso de la API de REST
<a name="restoring-objects-rest"></a>

Amazon S3 le proporciona una operación de la API para que pueda iniciar la restauración de un objeto archivado. Para obtener más información, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html) en la *Referencia de la API de Amazon Simple Storage Service*.

### Uso de los AWS SDK
<a name="restoring-objects-sdks"></a>

Para conocer ejemplos de cómo restaurar objetos archivados en S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive con los AWS SDK, consulte [Code examples](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_RestoreObject_section.html) en la *Amazon S3 API Reference*.

### Uso de Operaciones por lotes de S3
<a name="restoring-int-tier-archive-objects-batch-ops"></a>

Para restaurar más de un objeto archivado con una sola solicitud, puede utilizar Operaciones por lotes de S3. Proporcione a Operaciones por lotes de S3 una lista de objetos en los que operar. Operaciones por lotes de S3 llama a la operación de la API respectiva para realizar la operación especificada. Un solo trabajo de operaciones por lotes puede realizar la operación especificada en miles de millones de objetos con exabytes de datos. 

Para crear un trabajo de Operaciones por lotes, debe disponer de un manifiesto que contenga solo los objetos que desea restaurar. Puede crear un manifiesto mediante Inventario de S3 o puede proporcionar un archivo CSV con la información necesaria. Para obtener más información, consulte [Especificar un manifiesto](batch-ops-create-job.md#specify-batchjob-manifest).

Antes de crear y ejecutar trabajos de Operaciones por lotes de S3, debe conceder permisos a Amazon S3 para que realice Operaciones por lotes de S3 en su nombre. Para conocer los permisos necesarios, consulte [Concesión de permisos para Operaciones por lotes](batch-ops-iam-role-policies.md).

**nota**  
Los trabajos de Operaciones por lotes pueden operar en objetos de clase de almacenamiento de S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive *o* en objetos de nivel de almacenamiento Acceso a archivos o Acceso a archivos profundo de S3 Intelligent-Tiering. Operaciones por lotes no pueden funcionar con ambos tipos de objetos archivados en el mismo trabajo. Para restaurar objetos de ambos tipos, *debe* crear trabajos de operaciones por lotes independientes.  
Para obtener más información sobre cómo utilizar Operaciones por lotes para restaurar objetos archivados, consulte [Restaurara objetos con Operaciones por lotes](batch-ops-initiate-restore-object.md).

**Para crear un trabajo de Operaciones por lotes de S3 para iniciar la restauración de objetos**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Operaciones por lotes**.

1. Selecciona **Crear tarea** .

1. Para **Región de AWS**, elija la región en la que desea crear el trabajo.

1. En **Formato del manifiesto**, seleccione el tipo de manifiesto que desee usar.
   + Si elige **Informe de inventario de S3**, introduzca la ruta al objeto `manifest.json` que Amazon S3 generó como parte del informe de inventario con formato CSV. Si desea utilizar una versión del manifiesto distinta de la más reciente, introduzca el ID de versión del objeto `manifest.json`.
   + Si selecciona **CSV**, escriba la ruta del objeto del manifiesto con formato CSV. El objeto del manifiesto debe tener el mismo formato que se ha especificado en la consola. Si desea utilizar una versión distinta de la más reciente, puede incluir opcionalmente el ID de versión del objeto de manifiesto.

1. Elija **Siguiente**.

1. En la sección **Operación**, elija **Restaurar**.

1. En la sección **Restaurar**, para **Origen de restauración**, elija **Glacier Flexible Retrieval o Glacier Deep Archive** o **Nivel Acceso a archivos o Acceso a archivos profundo de Intelligent-Tiering**. 

   Si eligió **Glacier Flexible Retrieval o Glacier Deep Archive**, introduzca un número en **Número de días que está disponible la copia restaurada**. 

   En **Nivel de recuperación**, elija el nivel que desee utilizar.

1. Elija **Siguiente**.

1. 

   En la página **Configurar opciones adicionales**, rellene las siguientes secciones: 
   + En la sección **Opciones adicionales**, proporcione una descripción para el trabajo y especifique un número de prioridad para el trabajo. Los números más altos indican una mayor prioridad. Para obtener más información, consulte [Asignar prioridad a los trabajos](batch-ops-job-priority.md).
   + En la sección **Informe de finalización**, seleccione si Operaciones por lotes debe crear un informe de finalización. Para obtener más información sobre los informes de finalización, consulte [Informes de finalización](batch-ops-job-status.md#batch-ops-completion-report).
   + En la sección **Permisos**, debe conceder permisos a Amazon S3 para que ejecute Operaciones por lotes en su nombre. Para conocer los permisos necesarios, consulte [Concesión de permisos para Operaciones por lotes](batch-ops-iam-role-policies.md).
   + (Opcional) En la sección **Etiquetas de trabajo**, agregue etiquetas en pares clave-valor. Para obtener más información, consulte [Controlar el acceso y etiquetar trabajos usando etiquetas](batch-ops-job-tags.md).

   Cuando haya terminado, elija **Siguiente**.

1. En la página **Review (Revisar)**, puede verificar las configuraciones. Si necesita realizar cambios, seleccione **Anterior**. De lo contrario, seleccione **Crear trabajo**.

Para obtener más información sobre Operaciones por lotes, consulte [Restaurara objetos con Operaciones por lotes](batch-ops-initiate-restore-object.md) y [Creación de trabajos de operaciones por lotes de S3](batch-ops-create-job.md).

## Comprobación del estado de restauración y de la fecha de vencimiento
<a name="restore-archived-objects-status"></a>

Puede consultar el estado de una solicitud de restauración o la fecha de vencimiento mediante la consola de Amazon S3, las notificaciones de eventos de Amazon S3, la AWS CLI o la API de REST de Amazon S3.

**nota**  
Los objetos restaurados de las clases de almacenamiento S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive se almacenan solo durante el número de días que especifique. Los siguientes procedimientos devuelven la fecha de vencimiento de estas copias.   
Los objetos restaurados desde los niveles de almacenamiento S3 Intelligent-Tiering Archive Access y Deep Archive Access no tienen fecha de vencimiento y se trasladan de nuevo al nivel Acceso frecuente.

### Uso de la consola de S3
<a name="restore-archived-objects-status-console"></a>

**Para comprobar el estado de restauración y la fecha de caducidad de un objeto en la consola de Amazon S3**

1. Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets de uso general**.

1. En la lista de buckets, seleccione el nombre del bucket que contiene el objeto que va a restaurar.

1. En la lista **Objetos**, seleccione el objeto que va a restaurar. Aparece la página de detalles del objeto. 
   + Si la restauración no ha finalizado, en la parte superior de la página verá una sección que indica **Restauración en curso**.
   + Si la restauración ha finalizado, en la parte superior de la página verá una sección que indica **Restauración completa**. Si restaura desde S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive, esta sección también muestra la **Fecha de caducidad de la restauración**. Amazon S3 eliminará la copia restaurada de su objeto archivado en esta fecha.

### Uso de notificaciones de eventos de Amazon S3
<a name="restore-archived-objects-status-event-notifications"></a>

Puede recibir notificaciones sobre la finalización de la restauración del objeto mediante el uso de la acción `s3:ObjectRestore:Completed` con la característica Notificaciones de eventos de Amazon S3. Para obtener más información sobre cómo habilitar las notificaciones de eventos, consulte [Habilitación de notificaciones de Amazon SQS, Amazon SNS y AWS Lambda](how-to-enable-disable-notification-intro.md). Para obtener más información acerca de los diferentes tipos de eventos `ObjectRestore`, consulte [Tipos de eventos admitidos para SQS, SNS y Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types).

### Uso de AWS CLI
<a name="restore-archived-objects-status-cli"></a>

**Comprobar el estado de restauración y la fecha de caducidad de un objeto con la AWS CLI**  
En el siguiente ejemplo, se utiliza el comando `head-object` para ver los metadatos del objeto *`dir1/example.obj`* en el bucket `amzn-s3-demo-bucket`. Cuando ejecuta este comando en un objeto que se está restaurando, Amazon S3 devuelve si la restauración está en curso y (si procede) la fecha de caducidad.

```
aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj
```

Resultado previsto (restauración en curso):

```
{
    "Restore": "ongoing-request=\"true\"",
    "LastModified": "2020-06-16T21:55:22+00:00",
    "ContentLength": 405,
    "ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
    "VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {},
    "StorageClass": "GLACIER"
}
```

Resultado previsto (restauración finalizada):

```
{
    "Restore": "ongoing-request=\"false\", expiry-date=\"Wed, 12 Aug 2020 00:00:00 GMT\"",
    "LastModified": "2020-06-16T21:55:22+00:00",
    "ContentLength": 405,
    "ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
    "VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {},
    "StorageClass": "GLACIER"
}
```

Para obtener más información sobre `head-object`, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html) en la *Referencia de los comandos de AWS CLI*.

### Uso de la API de REST
<a name="restore-archived-objects-status-api"></a>

Amazon S3 proporciona una operación de la API para recuperar los metadatos de objeto. Para comprobar el estado de restauración y la fecha de caducidad de un objeto archivado mediante la API de REST, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html) en la *Referencia de la API de Amazon Simple Storage Service*.

## Actualizar la velocidad de una restauración en curso
<a name="restore-archived-objects-upgrade"></a>

Puede actualizar la velocidad de la restauración mientras esta se encuentra en curso.

**Para actualizar una restauración en curso a una capa más rápida**

1. Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Buckets**.

1. En la lista **Buckets**, seleccione el nombre del bucket que contiene los objetos que desea restaurar.

1. En la lista **Objetos**, seleccione el objeto que va a restaurar. Aparece la página de detalles del objeto. En la página de detalles del objeto, elija **Actualizar nivel de recuperación**. Para obtener más información sobre cómo comprobar el estado de restauración de un objeto, consulte [Comprobación del estado de restauración y de la fecha de vencimiento](#restore-archived-objects-status). 

1. Seleccione el nivel al que desea realizar la actualización y elija **Iniciar restauración**. 