All Products
Search
Document Center

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

Last Updated:Jun 14, 2024

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.

  • When you enable real-time access of Archive objects for a bucket, if you use the static website hosting feature to host a static website on the bucket and set the default homepage and the default 404 page of the static website to an Archive object that is not restored in the bucket, the default homepage or the default 404 page cannot be accessed and the 403 error code is returned. To ensure that the static website can be accessed, we recommend that you set the default homepage and default 404 page to Standard objects.

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

  1. Log on to the OSS console.

  2. In the left-side navigation pane, click Buckets. On the Buckets page, find and click the desired bucket.

  3. In the left-side navigation pane, choose Data Management > Real-time Access of Archive Objects.

  4. On the Real-time Access of Archive Objects page, turn on Real-time Access of Archive Objects.

  5. In the message that appears, click OK.

Use the OSS API

If your business requires a high level of customization, you can directly call RESTful APIs. 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.