全部产品
Search
文档中心

对象存储 OSS:PutBucketArchiveDirectRead

更新时间:Apr 28, 2024

调用PutBucketArchiveDirectRead接口为Bucket开启或关闭归档直读。

注意事项

  • 要为Bucket开启归档直读,您必须有oss:PutBucketArchiveDirectRead权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 每个地域都有对应的访问域名(Endpoint)。关于地域与访问域名对应关系的更多信息,请参见访问域名和数据中心

  • 开启归档直读后,直接读取归档存储类型的文件,会产生归档直读数据取回容量(RetrievalDataArchiveDirect)费用。对于已经解冻的归档存储类型的文件,不会产生归档直读数据取回容量费用。详情请参见数据处理费用

请求语法

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>

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)

请求元素

名称

类型

是否必选

示例值

描述

ArchiveDirectReadConfiguration

容器

不涉及

Bucket归档直读配置。

Enabled

布尔型

true

是否为Bucket开启归档直读。取值如下:

  • true:开启归档直读。

  • false:关闭归档直读。

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)

示例

  • 请求示例

    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>
  • 返回示例

    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