赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 关于Bucket操作
  7. 传输加速(TransferAcceleration)
  8. GetBucketTransferAcceleration

GetBucketTransferAcceleration

  • 传输加速(TransferAcceleration)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

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-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>

SDK

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

  • Java

  • Python

  • Go V2

  • PHP

命令行工具ossutil

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

错误码

错误码

HTTP状态码

描述

NoSuchTransferAccelerationConfiguration

404

请求的目标Bucket未配置传输加速。

相关文章

PutBucketTransferAcceleration 2025-04-21 18:15

PutBucketTransferAcceleration接口用于为存储空间(Bucket)配置传输加速。开启传输加速后,可提升全球各地用户对OSS的访问速度,适用于远距离数据传输、GB或TB级大文件上传和下载的场景。

GetBucketTransferAcceleration 2025-04-21 18:15

GetBucketTransferAcceleration接口用于获取目标存储空间(Bucket)的传输加速配置。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号