NavigationContentFooter
Jump toSuggest an edit

How to restore an object from Glacier

Reviewed on 13 June 2024Published on 27 May 2021

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
Important

Objects in Glacier can only be restored to Standard class.

Tip

To facilitate the steps of restoration and ensure fast restitution of your data, we recommend you store average-sized files (larger than 1 MB) in Glacier, as opposed to several small files.

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 in the previous step. Make sure to replace <YOUR-BUCKET> with the name of your bucket, and NUM with 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
Note

Use the Days=NUM parameter to specify the desired number of days. By default, the restoration period is one day.

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 the 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.

See also
How to edit the storage classHow to download files from a bucket
Docs APIScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCarreer
© 2023-2024 – Scaleway