You need to enable JavaScript to run this app.
Torch Object Storage

Torch Object Storage

  • Documentation
    • Torch Object StorageAPI ReferenceBucketTransfer AccelerationPutBucketTransferAcceleration
Copy page
Download PDF
Transfer Acceleration
PutBucketTransferAcceleration
Copy page
Download PDF
PutBucketTransferAcceleration

Feature Description

This API toggles transfer acceleration on or off for a bucket. By enabling transfer acceleration, you can improve TOS access speeds worldwide, suitable for long-distance data transfer and large file uploads and downloads.

Precautions

  • Only the Bucket owner and users granted the tos:PutBucketTransferAcceleration permission can configure transfer acceleration.

  • After enabling or disabling transfer acceleration, expect a 30-minute delay before the change takes effect.

  • After enabling transfer acceleration, you can access TOS via two types of domains. Acceleration benefits apply only when using the transfer acceleration domain; using the default domain does not provide acceleration benefits. Description as follows:

  • Default bucket domain:<bucketname>.tos-<Region>.volces.com.tos-accelerate.volces.com；<bucketname>.tos-s3-accelerate.volces.com

  • Transfer acceleration domains: <bucketname>.tos-accelerate.volces.com；<bucketname>.tos-s3-accelerate.volces.com

For more precautions about transfer acceleration, see Precautions.

Request syntax 

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

Request parameters and headers

This request requires setting the Content-MD5 value of the request element in the message header. It is compared with the MD5 value of the uploaded request element. If they do not match, an error will be returned. For other commonly used public request message headers, see Common Parameters.

NameLocationTypeRequiredSample ValueDescription
transferAccelerationQueryStringYes-Represents a special identifier for the PutBucketTransferAcceleration request.

Request body elements

NameTypeRequiredSample ValueDescription
TransferAccelerationConfigurationObjectYes-Transfer acceleration configuration.

Enabled

String

Is

true

Whether transfer acceleration is enabled for the target bucket. Values are as follows:

  • true: transfer acceleration is enabled.
  • false: transfer acceleration is disabled.

Response headers

This request returns the common response message headers. See Common Parameters.

Response body elements

There is no message element in this request response.

Sample request 

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

Sample response 

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
Last updated: 2025.06.30 11:00:38