GET Bucket Accelerate

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

    Feature description

    This API (GET Bucket Accelerate) is used to query the global acceleration configuration of 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. Valid return values of the global acceleration configuration status are Enabled and Suspended, indicating that global acceleration is enabled or suspended, respectively.
    3. If you are using a sub-account, in order to query the global acceleration configuration information of the bucket, you should have permission to read the configuration.

    Request

    Sample request

    GET /?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

    The request body of this request is empty.

    Response

    Response header

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

    Response body

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

    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
    Type AccelerateConfiguration Global acceleration type. Enumerated value: COS Enum

    Error codes

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

    Use cases

    Request

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

    Response 1 (global acceleration enabled)

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

    Response 2 (global acceleration suspended)

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

    Response 3 (global acceleration not enabled)

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

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help