All Products
Search
Document Center

Object Storage Service:GetBucketArchiveDirectRead

Last Updated:Jun 18, 2026

Queries whether real-time access of Archive objects is enabled for a bucket.

Usage notes

  • To check whether real-time access of Archive objects is enabled for a bucket, you must have the oss:GetBucketArchiveDirectRead permission. For more information, see Grant a custom policy.

  • Each region has its own Object Storage Service (OSS) endpoints. For more information, see Regions and Endpoints.

Request syntax

GET /?bucketArchiveDirectRead HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

This operation uses only common request headers. For more information, see Common HTTP headers.

Response headers

This operation returns only common response headers. For more information, see Common HTTP headers.

Header

Type

Required

Example

Description

ArchiveDirectReadConfiguration

Container

Yes

N/A

The container for real-time access configurations of Archive objects.

Enabled

Boolean

Yes

true

Indicates whether real-time access of Archive objects is enabled for the bucket. Valid values:

  • true

  • false

Examples

  • Sample request

    GET /?bucketArchiveDirectRead HTTP/1.1 
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
    Date: Mon, 24 Apr 2023 15:56:37 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • Sample response

    GET /?bucketArchiveDirectRead HTTP/1.1
    Date: Mon, 24 Apr 2023 15:56:37 GMT
    Content-Length: 60
    Content-Type: application/xml
    Authorization: OSS qn6q**************:77Dv****************
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    
    <?xml version="1.0" encoding="UTF-8"?>
    <ArchiveDirectReadConfiguration>
        <Enabled>true</Enabled>
    </ArchiveDirectReadConfiguration>

ossutil

For the ossutil command that corresponds to this operation, see get-bucket-archive-direct-read.