調用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開啟歸檔直讀。取值如下:
|
回應標頭
此介面僅涉及公用回應標頭。更多資訊,請參見公用回應標頭(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