GetBucketTransferAcceleration

注意事项

• 只有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

返回参数

此接口涉及的x-oss-request-id、Date等其他公共响应头的更多信息，请参见公共响应头（Common Response Headers）。

示例

• 请求示例

  以下请求示例用于获取目标存储空间examplebucket的传输加速状态。

  GET /?transferAcceleration HTTP/1.1
  Date: Thu, 17 Apr 2025 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

• 返回示例

  以下返回示例表明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>

SDK

此接口所对应的各语言SDK如下：

• Java

• Python V2

• Go V2

• PHP V2

命令行工具ossutil

GetBucketTransferAcceleration接口所对应的ossutil命令，请参见get-bucket-transfer-acceleration。

错误码