Restauración de un objeto archivado

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.

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 '{}'

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 restore-object en la Referencia de los comandos de AWS CLI.

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 RestoreObject en la Referencia de la API de Amazon Simple Storage Service.

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 en la Amazon S3 API Reference.

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.

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.

Para obtener más información sobre Operaciones por lotes, consulte Restaurara objetos con Operaciones por lotes y Creación de trabajos de operaciones por lotes de S3.

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. Para obtener más información acerca de los diferentes tipos de eventos ObjectRestore, consulte Tipos de eventos admitidos para SQS, SNS y Lambda.

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.objen 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 head-object en la Referencia de los comandos de AWS CLI.

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 HeadObject en la Referencia de la API de Amazon Simple Storage Service.