Storage Tiers

GDS provides archive functionality for backup of file and folder data.

Archive Requests

Files and folders are archived via the following endpoints:

POST v1/files/{fileId}:archive

POST v1/folders/{folderId}:archive

Both endpoints accept an optional storageTier parameter in the request body. GDS provides two archival storage tiers:

• Archive

  The Archive tier is the default storage tier used for archival and has configurable retrieval times from minutes to hours. This tier utilizes the S3 Glacier storage class within AWS S3.

  Archive requests use this tier by default, but it can also be supplied in the request body:

  {
      "storageTier": "Archive"
  }

• Deep Archive

  The Deep Archive tier is the lowest cost archival storage tier and has a retrieval time of up to 12 hours. This tier utilizes the S3 Deep Glacier storage class within AWS S3.

  To archive using this tier, supply the following parameter in the request body:

  {
      "storageTier": "DeepArchive"
  }

Unarchive Requests

Archived files and folders are restored via the following endpoints:

POST v1/files/{fileId}:unarchive

POST v1/folders/{folderId}:unarchive

Both endpoints require a restoreSpeed parameter to be supplied in the request body. The following restore speeds are available in GDS:

• Economy

  The Economy restore speed class is the lowest-cost option which typically restores within 5-12 hours for objects archived using the Archive storage tier, and within 48 hours for objects archived using the DeepArchive storage tier. This speed class utilizes the Bulk retrieval option within AWS S3.

  To restore using the Economy speed class, supply the following parameter in the request body:

  {
      "restoreSpeed": "Economy"
  }

• Standard

  The Standard restore speed class typically restores within 3-5 hours for objects archived using the Archive storage tier, and within 12 hours for objects archived using the DeepArchive storage tier. This speed class utilizes the Standard retrieval option within AWS S3.

  To restore using the Standard speed class, supply the following parameter in the request body:

  {
      "restoreSpeed": "Standard"
  }

The following table summarizes the archival storage tiers and restore speeds:

GDS Storage Tier	AWS Storage Tier	Economy	Standard	Fast
Archive	S3 Glacier	5 - 12 Hours	3 - 5 Hours	1 - 5 Minutes
Deep Archive	S3 Deep Glacier	Within 48 Hours	Within 12 Hours	Not Available