Overview

This API is used to query the global acceleration configuration of a bucket.

Notes

1. If you have never enabled global acceleration for the bucket, the global acceleration status will not be returned even if you call this API.
2. Valid values of Status are Enabled and Suspended.
3. If a sub-account needs to call this API, it needs to have permission to read the global acceleration configuration.

Request

Sample request

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

Note：

• In Host: <bucketname-appid>.cos.<region>.myqcloud.com, is the bucket name followed by the APPID, such as examplebucket-1250000000 (see Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions), and is a COS region (see Regions and Access Endpoints).
• Authorization: Auth String (see Request Signature for more information).

Request headers

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 headers

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

Response body

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

The nodes are described as follows:

Error codes

This API returns common error responses and error codes. For more information, please see Error Codes.

Sample

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