全部產品
Search
文件中心

Object Storage Service:GetBucketTransferAcceleration

更新時間:Jun 19, 2024

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

傳輸加速狀態。取值範圍如下:

  • true:開啟傳輸加速。

  • false:關閉傳輸加速。

此介面涉及的x-oss-request-idDate等其他公用回應標頭的更多資訊,請參見公用回應標頭(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未配置傳輸加速。