Access Archive objects in real time without restoring them - Object Storage Service

If you enable real-time access of Archive objects for an Object Storage Service (OSS) bucket, you can access Archive objects in the bucket without the need to restore the Archive objects. This feature is suitable for real-time access of extremely infrequently accessed data. This topic describes how to enable and use real-time access of Archive objects.

Prerequisites

A region-specific bucket is created. For more information, see Create a bucket.
A RAM user is granted the following permissions if you want to use the RAM user to access Archive objects in real time without the need to restore them: oss:PutBucketArchiveDirectRead and oss:GetBucketArchiveDirectRead. For more information, see Attach a custom policy to a RAM user.

Limits

Real-time access of Archive objects can be used to access only Archive objects without the need to restore them.

Scenarios

Real-time access of Archive objects is suitable for scenarios that involve data lakes, cloud photo albums, media asset archiving, and medical images. Real-time access of Archive objects meets the requirements for real-time access of data that is extremely infrequently accessed while reducing the overall storage costs.

Billing rules

After you enable real-time access of Archive objects for a bucket, when you access Archive objects that are not restored in the bucket, you are charged Archive data retrieval fees based on the size of accessed Archive data (RetrievalDataArchiveDirect). When you access Archive objects that are restored in the bucket, you are not charged Archive data retrieval fees. For more information, see Data processing fees.
The size of directly accessed Archive data depends on the data range specified in the request headers when an HTTP connection is established. Early disconnection does not affect the size of directly accessed data that has been requested.

Feature comparison

The following table describes the differences before and after you enable real-time access of Archive objects.

Item	Disable real-time access of Archive objects (default)	Enable real-time access of Archive objects
Data retrieval method	Restore Archive objects and then access the Archive objects	Directly access Archive objects
Data retrieval fees ^①	Low	High
Data retrieval time	Minutes	Milliseconds

^① For more information about data retrieval fees, visit the OSS pricing page.

Procedure

Use the OSS console

Log on to the OSS console.
In the left-side navigation pane, click Buckets. On the Buckets page, find and click the desired bucket.
In the left-side navigation pane, choose Data Management > Real-time Access of Archive Objects.
On the Real-time Access of Archive Objects page, turn on Real-time Access of Archive Objects.
In the message that appears, click OK.

Use the OSS API

If your business requires a high level of customization, you can directly call the OSS API. To directly call an API, you must include the signature calculation in your code. For more information, see PutBucketArchiveDirectRead and GetBucketArchiveDirectRead.

What to do next

After you enable real-time access of Archive objects for a bucket, you can perform the following operations on the Archive objects in the bucket without the need to restore them:

References

If you do not enable real-time access of Archive objects for the bucket, you must restore the Archive objects before you can access them. For more information, see Restore objects.