How to restore an object from Glacier

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization
• An Object Storage bucket
• An object in Glacier storage class

How to restore an object

1. Click Object Storage in the Storage section of the side menu. The list of your buckets displays.

2. Click the bucket name that contains the objects you want to restore to STANDARD class. The list of objects displays.

3. Click «See more Icon», then select Restore from the drop-down menu.

   A pop-up appears.

4. Enter the number of days after which the object will be transferred back to Glacier, or click the toggle to permanently restore the object.

5. Click Restore object from S3 Glacier.

Your object remains available in Standard class for the duration you specified. It will be transferred automatically back to Glacier once the configured period is over.

How to restore all objects in a bucket

If you have numerous files in a bucket that you would like to restore, we recommend using the command line interface, with a dedicated tool such as the AWS CLI.

1. Run the command below in a terminal to create a list of objects to restore, and store it as a text file. Make sure to replace <YOUR-BUCKET> with the name of your bucket.

   aws s3api list-objects-v2 --bucket <YOUR-BUCKET> --query "Contents[?StorageClass=='GLACIER']" --output text | awk '{print $2}' > glacier-restore.txt
   

   Note

   The list-objects-v2 operation is limited to 1,000 objects.

2. Run the following command to restore every object listed at the previous step. Make sure to replace <YOUR-BUCKET> with the name of your bucket, and NUM by the desired number of days.

   for x in `cat glacier-restore.txt`
     do
       aws s3api restore-object --restore-request Days=NUM --bucket <YOUR-BUCKET> --key "$x"
     done
   

Restore time

The time it takes to restore an object depends on the size of the object and if multipart is configured. If your object is larger than 1 MB, it can take anywhere from a few minutes to 24 hours for restore to start.

For multipart objects, each part is equivalent to one object. Consequently, the more parts your object has, the longer the restore time will be.

To determine how many parts a multipart object has, you can run the following aws-cli command:

aws s3api <object-name> --bucket <bucket-name> --key b

For a multipart object, the Etag includes a suffix that indicates the number of parts of the object. In the example below, the -<PartNumber> is 14:

{
    "AcceptRanges": "bytes",
    "LastModified": "2022-08-16T12:07:00+00:00",
    "ContentLength": 141855946,
    "ETag": "\"df1c7b0641b048c77f7177e3d22dde78-14\"",
    "VersionId": "1660651620102268",
    "ContentType": "application/x-tar",
    "Metadata": {}
}

Therefore, in this example, the time it takes to restore the object (that has 14 parts) is equivalent to the time it takes to restore 14 objects.