PutBucketArchiveDirectRead

注意事项

• 要为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）。

请求元素

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（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

命令行工具ossutil

PutBucketArchiveDirectRead接口所对应的ossutil命令，请参见put-bucket-archive-direct-read。