Feature description

This API (PUT Bucket Accelerate) is used to enable or suspend global acceleration for the specified bucket.

Detail analysis

1. If you have never enabled global acceleration for the bucket, the request to the GET Bucket Accelerate API will not return global acceleration configuration status.
2. Once enabled, global acceleration can only be suspended but cannot be disabled.
3. Valid values of the global acceleration configuration status are Enabled and Suspended, indicating that global acceleration is enabled or suspended, respectively.
4. If you are using a sub-account, in order to set the global acceleration feature for the bucket, you should have permission to write the configuration.

Request

Sample request

PUT /?accelerate HTTP 1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT date
Authorization: Auth String

Authorization: Auth String (for more information, please see Request Signature).

Request header

This API only uses common request headers. For more information, please see Common Request Headers.

Request body

<AccelerateConfiguration xmlns="cos xmlns/"> 
  <Status>Enabled</Status> 
</AccelerateConfiguration>

Detailed nodes are as shown below:

Response

Response header

This API only returns common response headers. For more information, please see Common Response Headers.

Response body

The response body return is empty.

Error codes

This API uses standardized error responses and error codes. For more information, see Error Codes .

Use cases

Request

PUT /?accelerate HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Connection: keep-alive
Authorization: authorization string
Content-Type: text/plain
Content-Length: 83

<AccelerateConfiguration>
    <Status>Enabled</Status>
</AccelerateConfiguration>

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Wed, 23 Aug 2019 08:14:53 GMT
Server: tencent-cos
x-cos-request-id: NTk5ZDM5N2RfMjNiMjM1MGFfMmRiX2Y0****