PUT Bucket Accelerate

Last updated: 2020-06-30 17:45:03

    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.


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

    Detailed nodes are as shown below:

    Node Name (Keyword) Parent Node Description Type
    AccelerateConfiguration None Detailed information of global acceleration Container
    Status AccelerateConfiguration Indicates whether global acceleration is enabled. Enumerated values: Suspended, Enabled Enum


    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


    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


    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****