All Products
Search

This Product

    Object Storage Service:PutBucketArchiveDirectRead

    Document Center

    Object Storage Service:PutBucketArchiveDirectRead

    Last Updated:Apr 28, 2024

    Enables or disables real-time access of Archive objects for a bucket.

    Usage notes

    • To enable real-time access of Archive objects for a bucket, you must have the oss:PutBucketArchiveDirectRead permission. For more information, see Attach a custom policy to a RAM user.

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

    • 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 the 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.

    Request syntax

    PUT /?bucketArchiveDirectRead HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com

<?xml version="1.0" encoding="UTF-8"?>
<ArchiveDirectReadConfiguration>
    <Enabled>true</Enabled>
</ArchiveDirectReadConfiguration>

    Request headers

    All headers in a PutBucketArchiveDirectRead request are common request headers. For more information, see Common HTTP headers.

    Request elements

    Element

    Type

    Required

    Example

    Description

    ArchiveDirectReadConfiguration

    Container

    Yes

    N/A

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

    Enabled

    Boolean

    Yes

    true

    Specifies whether to enable real-time access of Archive objects for a bucket. Valid values:

    • true

    • false

    Response headers

    All headers in the response to a PutBucketArchiveDirectRead request are common response headers. For more information about common response headers, see Common HTTP headers.

    Examples

    • Sample request

      PUT /?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>

    • Sample response

      HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Mon, 24 Apr 2023 15:56:37 GMT
Content-Length: 60
Connection: keep-alive
Server: AliyunOSS