全部產品
Search
文件中心

Object Storage Service:PutBucketArchiveDirectRead

更新時間:Jun 19, 2024

調用PutBucketArchiveDirectRead介面為Bucket開啟或關閉歸檔直讀。

注意事項

  • 要為Bucket開啟歸檔直讀,您必須有oss:PutBucketArchiveDirectRead許可權。具體操作,請參見為RAM使用者授權自訂的權限原則

  • 每個地區都有對應的訪問網域名稱(Endpoint)。關於地區與訪問網域名稱對應關係的更多資訊,請參見訪問網域名稱和資料中心

  • 開啟歸檔直讀後,直接讀取Archive Storage類型的檔案,會產生歸檔直讀資料取回容量(RetrievalDataArchiveDirect)費用。對於已經解凍的Archive Storage類型的檔案,不會產生歸檔直讀資料取回容量費用。詳情請參見資料處理費用

請求文法

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