PutBucketTransferAcceleration
PutBucketTransferAcceleration接口用于為存儲空間(Bucket)配置傳輸加速。開啟傳輸加速后,可提升全球各地用戶對OSS的訪問速度,適用于遠(yuǎn)距離數(shù)據(jù)傳輸、GB或TB級大文件上傳和下載的場景。
注意事項
只有Bucket擁有者以及被授予oss:PutBucketTransferAcceleration權(quán)限的RAM用戶才能發(fā)起配置傳輸加速的請求。
開啟傳輸加速后,Bucket會在保留默認(rèn)Endpoint的基礎(chǔ)上新增傳輸加速域名,但必須使用OSS的傳輸加速域名才會提升訪問速度。
使用傳輸加速域名訪問Bucket時,OSS會收取傳輸加速費用。詳情請參見傳輸加速費用。
關(guān)于傳輸加速的更多信息,請參見傳輸加速。
請求語法
PUT /?transferAcceleration HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue
請求參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
TransferAccelerationConfiguration | 容器 | 是 | 不涉及 | 傳輸加速配置的容器。 |
Enabled | 字符串 | 是 | true | 目標(biāo)Bucket是否開啟傳輸加速。取值如下:
重要 傳輸加速開啟及關(guān)閉操作在30分鐘內(nèi)生效。 |
此接口涉及Authorization、Content-Length等其他公共請求頭的更多信息,請參見公共請求頭(Common Request Headers)。
響應(yīng)頭
此接口僅涉及x-oss-request-id、Date等公共響應(yīng)頭。有關(guān)公共響應(yīng)頭的更多信息,請參見公共響應(yīng)頭(Common Response Headers)。
示例
請求示例
為目標(biāo)存儲空間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狀態(tài)碼 | 描述 |
AccessDenied | 404 | 沒有操作權(quán)限。僅支持擁有oss:PutBucketTransferAcceleration權(quán)限的用戶配置傳輸加速。 |
MalformedXML | 400 | 請求的XML格式不合法。例如,請求字段<Enabled>設(shè)置為true或者false以外的非法值。 |