Restoring an archived object

Restore objects using the Amazon S3 console

Use the following procedure to Restore an object that has been archived to the S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes, or the S3 Intelligent-Tiering Archive Access or Deep Archive Access storage tiers.

Restore objects from S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive

The following example uses the restore-object command to restore the object dir1/example.obj in the bucket amzn-s3-demo-bucket for 25 days.

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

If the JSON syntax used in the example results in an error on a Windows client, replace the restore request with the following syntax:

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

Restore objects from S3 Intelligent-Tiering Archive Access and Deep Archive Access

The following example uses the restore-object command to restore the object dir1/example.obj in the bucket amzn-s3-demo-bucket to the Frequent Access tier.

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

Monitor restore status

To monitor the status of your restore-object request, use the following head-object command:

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

For more information, see restore-object in the AWS CLI Command Reference.

Amazon S3 provides an API operation for you to initiate the restoration of an archived object. For more information, see RestoreObject in the Amazon Simple Storage Service API Reference.

For examples of how to restore archived objects in S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive with the AWS SDKs, see Code examples in the Amazon S3 API Reference.

To restore more than one archived object with a single request, you can use S3 Batch Operations. You provide S3 Batch Operations with a list of objects to operate on. S3 Batch Operations calls the respective API operation to perform the specified operation. A single Batch Operations job can perform the specified operation on billions of objects containing exabytes of data.

To create a Batch Operations job, you must have a manifest that contains only the objects that you want to restore. You can create a manifest by using S3 Inventory, or you can supply a CSV file with the necessary information. For more information, see Specifying a manifest.

Before creating and running S3 Batch Operations jobs, you must grant permissions to Amazon S3 to perform S3 Batch Operations on your behalf. For the required permissions, see Granting permissions for Batch Operations.

For more information about Batch Operations, see Restore objects with Batch Operations and Creating an S3 Batch Operations job.

You can be notified of object restoration completion by using the s3:ObjectRestore:Completed action with the Amazon S3 Event Notifications feature. For more information about enabling event notifications, see Enabling notifications by using Amazon SQS, Amazon SNS, and AWS Lambda. For more information about the various ObjectRestore event types, see Supported event types for SQS, SNS, and Lambda.

Check an object's restore status and expiration date with the AWS CLI

The following example uses the head-object command to view metadata for the object dir1/example.obj in the bucket amzn-s3-demo-bucket. When you run this command on an object being restored Amazon S3 returns if the restore is ongoing and (if applicable) the expiration date.

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

Expected output (restore ongoing):

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

Expected output (restore finished):

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

For more information about head-object, see head-object in the AWS CLI Command Reference.

Amazon S3 provides an API operation for you to retrieve object metadata. To check the restoration status and expiration date of an archived object using the REST API, see HeadObject in the Amazon Simple Storage Service API Reference.