GetBucketTransferAcceleration介面用於擷取目標儲存空間(Bucket)的傳輸加速配置。
注意事項
只有Bucket擁有者以及被授予oss:GetBucketTransferAcceleration許可權的RAM使用者才能發起擷取傳輸加速配置的請求。
如果Bucket未配置過傳輸加速,調用該介面時不返回加速配置狀態。
有關傳輸加速的更多資訊,請參見開發指南的傳輸加速。
請求文法
GET /?transferAcceleration HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue
返回參數
名稱 | 類型 | 樣本值 | 描述 |
TransferAccelerationConfiguration | 容器 | 不涉及 | 儲存傳輸加速配置資訊的容器。 |
Enabled | 字串 | true | 傳輸加速狀態。取值範圍如下:
|
此介面涉及的x-oss-request-id、Date等其他公用回應標頭的更多資訊,請參見公用回應標頭(Common Response Headers)。
樣本
請求樣本
以下請求樣本用於擷取目標儲存空間examplebucket的傳輸加速狀態。
GET /?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****************
返回樣本
以下返回樣本表明examplebucket已開啟傳輸加速。
HTTP/1.1 200 OK x-oss-request-id: 534B371674E88A4D8906**** Date: Fri , 30 Apr 2021 13:08:38 GMT <TransferAccelerationConfiguration> <Enabled>true</Enabled> </TransferAccelerationConfiguration>
錯誤碼
錯誤碼 | HTTP狀態代碼 | 描述 |
NoSuchTransferAccelerationConfiguration | 404 | 請求的目標Bucket未配置傳輸加速。 |