Object Storage Service:GetBucketTransferAcceleration

Usage notes

• Only the owner of a bucket or RAM users granted with the oss:PutBucketTransferAcceleration permission can initiate requests to query the transfer acceleration configurations of a bucket.

• If transfer acceleration is not configured for the bucket to which you send the GetBucketTransferAcceleration request, no configurations are returned.

For more information about transfer acceleration, see Transfer acceleration in the Developer Guide.

Request structure

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

Response parameters

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

Examples

• Sample requests

  The following sample request is used to query the status of transfer acceleration of a bucket named 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****************

• Sample responses

  The following response indicates that transfer acceleration is enabled for 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>

Error codes