Object Storage Service:PutBucketTransferAcceleration

Usage notes

• Only the owner of a bucket or RAM users to which the oss:PutBucketTransferAcceleration permission is granted can initiate requests to configure transfer acceleration for the bucket.

• After you enable transfer acceleration for a bucket, you can use an accelerate endpoint in addition to the default endpoint to access the bucket. The access speed is accelerated only when you use the accelerate endpoint.

• You are charged for the transfer acceleration fees when you use the accelerate endpoint to access a bucket. For more information, see Transfer acceleration fees.

For more information about transfer acceleration, see Enable transfer acceleration.

Request structure

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

Request parameters

For more information about the common request headers contained in a PutBucketTransferAcceleration request, such as Authorization and Content-Length, see Common request headers.

Response headers

All headers contained in the response to a PutBucketTransferAcceleration request are common response headers, such as x-oss-request-id and Date. For more information about the common response headers, see Common response headers.

Examples

• Sample requests

  The following sample request is used to enable transfer acceleration for a bucket named 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: OSS qn6qrrqxo2oawuk53otf****:PYbzsdWAIWAlMW8luk****
  <TransferAccelerationConfiguration>
    <Enabled>true</Enabled>
  </TransferAccelerationConfiguration>

• Sample responses

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

Error codes