

# 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**. 