PutBucketTransferAcceleration介面用於為儲存空間(Bucket)配置傳輸加速。開啟傳輸加速後,可提升全球各地使用者對OSS的訪問速度,適用於遠距離資料轉送、GB或TB級大檔案上傳和下載的情境。
注意事項
只有Bucket擁有者以及被授予oss:PutBucketTransferAcceleration許可權的RAM使用者才能發起配置傳輸加速的請求。
開啟傳輸加速後,Bucket會在保留預設Endpoint的基礎上新增傳輸加速網域名稱,但必須使用OSS的傳輸加速網域名稱才會提升訪問速度。
使用傳輸加速網域名稱訪問Bucket時,OSS會收取傳輸加速費用。詳情請參見傳輸加速費用。
關於傳輸加速的更多資訊,請參見傳輸加速。
請求文法
PUT /?transferAcceleration HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue
請求參數
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
TransferAccelerationConfiguration | 容器 | 是 | 不涉及 | 傳輸加速配置的容器。 |
Enabled | 字串 | 是 | true | 目標Bucket是否開啟傳輸加速。取值如下:
重要 傳輸加速開啟及關閉操作在30分鐘內生效。 |
此介面涉及Authorization、Content-Length等其他公用要求標頭的更多資訊,請參見公用要求標頭(Common Request Headers)。
回應標頭
此介面僅涉及x-oss-request-id、Date等公用回應標頭。有關公用回應標頭的更多資訊,請參見公用回應標頭(Common Response Headers)。
樣本
請求樣本
為目標儲存空間examplebucket開啟傳輸加速的請求樣本如下:
PUT /?transferAcceleration HTTP/1.1 Date: Fri, 30 Apr 2021 13:08:38 GMT Content-Length:443 Content-Type: application/xml Host: examplebucket.oss.aliyuncs.com Authorization: OSS qn6q**************:77Dv**************** <TransferAccelerationConfiguration> <Enabled>true</Enabled> </TransferAccelerationConfiguration>
返回樣本
HTTP/1.1 200 OK x-oss-request-id: 534B371674A4D890**** Date: Fri, 30 Apr 2021 13:08:38 GMT Content-Length: 443 Connection: keep-alive Server: AliyunOSS
錯誤碼
錯誤碼 | HTTP狀態代碼 | 描述 |
AccessDenied | 404 | 沒有操作許可權。僅支援擁有oss:PutBucketTransferAcceleration許可權的使用者配置傳輸加速。 |
MalformedXML | 400 | 請求的XML格式不合法。例如,請求欄位<Enabled>設定為true或者false以外的非法值。 |