全部產品
Search
文件中心

Object Storage Service:PutBucketTransferAcceleration

更新時間:Jun 19, 2024

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是否開啟傳輸加速。取值如下:

  • true:開啟傳輸加速。

  • false:關閉傳輸加速。

重要

傳輸加速開啟及關閉操作在30分鐘內生效。

此介面涉及AuthorizationContent-Length等其他公用要求標頭的更多資訊,請參見公用要求標頭(Common Request Headers)

回應標頭

此介面僅涉及x-oss-request-idDate等公用回應標頭。有關公用回應標頭的更多資訊,請參見公用回應標頭(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以外的非法值。