Feature Overview
COS supports direct upload to the ARCHIVE storage class by using the console, APIs, SDKs, or COSCMD. Alternatively, you can use the lifecycle feature of COS to transition your objects to the ARCHIVE or DEEP ARCHIVE storage class. For more information, see Storage Class Overview.
Supported Methods
Console Upload
Use the COS Console to upload files. After selecting the object to upload, set the storage class to ARCHIVE or DEEP ARCHIVE in the object properties. For more information, see Uploading Objects.
API Upload
Set the x-cos-storage-class to ARCHIVE or DEEP_ARCHIVE in PUT Object, POST Object, or Initiate Multipart Upload to enable direct upload to the ARCHIVE storage class.
Note
Append Object does not support direct upload to the ARCHIVE storage class.
SDK Upload
All current COS SDKs support direct upload to the ARCHIVE storage class. To do this, set the StorageClass parameter to ARCHIVE or DEEP_ARCHIVE during file upload.
COSCMD Tool Upload
The COSCMD tool supports direct upload to the ARCHIVE storage class. To do this, add the header field x-cos-storage-class and set it to ARCHIVE or DEEP_ARCHIVE during file upload.
Restoring and downloading archived data
Unlike STANDARD/STANDARD_IA, objects in ARCHIVE or DEEP ARCHIVE can only be downloaded after being restored. The following three restoration modes are provided:
Expedited: Restores an object within 1–5 minutes (fastest).
Standard: Restores an object within 3–5 hours.
Bulk: Restores multiple objects within 5–12 hours (most cost-effective).
Note
Objects in DEEP ARCHIVE cannot be restored in the expedited mode. An object can be restored within 12–24 hours in standard mode or 24–48 hours in bulk mode.
In addition, the console, API, SDK, and COSCMD tool all support archive storage restoration and download.
Restrictions
Objects in ARCHIVE or DEEP ARCHIVE need to be restored before being downloaded.
To copy an object in ARCHIVE or DEEP ARCHIVE, you need to restore it first.
Objects in ARCHIVE and DEEP ARCHIVE do not support cross-region replication.
Objects in ARCHIVE and DEEP ARCHIVE cannot be changed to a more frequently accessed storage class, such as STANDARD and STANDARD_IA.