You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/API 参考/存储桶/传输加速/PutBucketTransferAcceleration
PutBucketTransferAcceleration
最近更新时间：2024.09.05 17:35:27首次发布时间：2024.08.01 19:52:14
我的收藏

功能描述

此接口用于为存储桶开启或关闭传输加速。通过设置传输加速，您可以提升全球各地用户对 TOS 的访问速度，适用于远距离传输数据、大文件上传和下载场景。

注意事项

  • 只有 Bucket 拥有者以及被授予 tos：PutBucketTransferAcceleration 权限的用户可以配置传输加速。
  • 开启或关闭传输加速功能后，预计需要等待 30 分钟，才能生效。
  • 开启传输加速功能后，您可以使用两种域名访问 TOS。仅使用传输加速域名时，可以享受加速效果；使用默认域名，不享受传输加速效果。说明如下：
    • 桶默认域名：<bucketname>.tos-<Region>.volces.com
    • 传输加速域名：<bucketname>.tos-accelerate.volces.com；<bucketname>.tos-s3-accelerate.volces.com

关于传输加速的更多注意事项介绍，请参见注意事项。

请求消息样式

PUT /?transferAcceleration HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Content-MD5: content-md5 string
Authorization: authorization string
Content-Length: length
{
  "TransferAccelerationConfiguration": {
     "Enabled": "true"
  }
}

请求参数和消息头

该请求需要在消息头中设置请求元素的 Content-MD5 值，与上传的请求元素的 MD5 值进行比较，如果不相等，将返回错误。其他使用的公共请求消息头，请参见公共参数。

名称

位置

参数类型

是否必选

示例值

说明

transferAcceleration

Query

String

是

-

代表 PutBucketTransferAcceleration 请求的特殊标识。

请求元素

名称

参数类型

是否必选

示例值

说明

TransferAccelerationConfiguration

Object

是

-

传输加速配置。

Enabled

String

是

true

目标Bucket是否开启传输加速。取值如下：

  • true：开启传输加速。
  • false：关闭传输加速。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

PUT /?transferAcceleration HTTP/1.1
Host: examplebucket.tos-cn-beijing.volces.com
Date: Mon, 31 Oct 2016 12:00:00 GMT
Authorization: authorization string
Content-MD5: ContentMD5
Content-Length: length

{
  "TransferAccelerationConfiguration": {
     "Enabled": "true"
  }
}

响应示例

HTTP/1.1 200 OK
Date: Sat, 07 Oct 2023 09:02:23 GMT
Server: TosServer
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0
Content-Length: 0