How Do I Access or Retrieve an Object From Vultr Archival Object Storage?

Accessing an archived object is a two-step process: restoring the object from Archival back to your bucket, followed by downloading it. For smaller objects, you can retrieve the object directly by executing Step 2 and downloading it using a normal get (s3cmd) / get-object (AWS CLI) request.

1. Restoring an object returns it to your bucket for a specified number of days, after which it is automatically returned to Archival.

   • s3cmd

     console Copy

     $ s3cmd -c S3_CONFIG --restore-days=DAYS restore s3://BUCKET_NAME/OBJECT_KEY
     

     Explain Code

   • AWS CLI

     console Copy

     $ aws s3api restore-object --bucket BUCKET_NAME --key OBJECT_KEY --restore-request Days=DAYS
     

     Explain Code

   If the object is large and the restore is still in progress, the request will return the following error:

   ERROR: S3 error: 400 (RequestTimeout): restore is still in progress

   In this case, wait for the restore to complete before attempting to download the object.

2. Once the object has been restored, download it using either s3cmd or the AWS CLI.

   • s3cmd

     console Copy

     $ s3cmd -c S3_CONFIG get s3://BUCKET_NAME/OBJECT_KEY
     

     Explain Code

   • AWS CLI

     console Copy

     $ aws s3api get-object --bucket BUCKET_NAME --key OBJECT_KEY OUTPUT_FILE
     

     Explain Code