Object Storage Service：PutBucketTransferAcceleration

注意事項

• 開啟傳輸加速後，Bucket會在保留預設Endpoint的基礎上新增傳輸加速網域名稱，但必須使用OSS的傳輸加速網域名稱才會提升訪問速度。

• 使用傳輸加速網域名稱訪問Bucket時，OSS會收取傳輸加速費用。詳情請參見傳輸加速費用。

關於傳輸加速的更多資訊，請參見傳輸加速。

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。

請求文法

PUT /?transferAcceleration HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue

請求參數

此介面涉及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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <TransferAccelerationConfiguration>
    <Enabled>true</Enabled>
  </TransferAccelerationConfiguration>

• 返回樣本

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674A4D890****
  Date: Thu, 17 Apr 2025 13:08:38 GMT
  Content-Length: 443
  Connection: keep-alive
  Server: AliyunOSS

SDK

此介面所對應的各語言SDK如下：

• Java

• Python V2

• Go V2

• PHP V2

命令列工具ossutil

PutBucketTransferAcceleration介面所對應的ossutil命令，請參見put-bucket-transfer-acceleration。

錯誤碼