GET Bucket Referer

Last updated: 2019-12-14 10:52:58


This API (GET Bucket Referer) is used to read the whitelist or the blacklist of Bucket Referer.


Request example

GET /?referer HTTP 1.1
Date: GMT Date
Authorization: Auth String

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

Request headers

Common headers

Common request headers are used for the implementation of this request operation. For more information, see Common Request Headers.

Special request headers

This request operation does not use any special request header.

Request body

The request body of this request is empty.


Response headers

Common response headers

This response uses common response headers. For more information, see Common Response Headers.

Special response headers

This response does not use any special response header.

Response body

Application/xml data is returned in the response body. It contains the complete node data, as shown below:


Detailed data is shown as below:

Name Parent Node Description Type Required
RefererConfiguration None Hotlink protection configuration Container Yes
Status RefererConfiguration Indicates whether to enable hotlink protection. Enumerated value: Enabled and Disabled String Yes
RefererType RefererConfiguration Hotlink protection type. Enumerated value: Black-List and White-List String Yes
DomainList RefererConfiguration Sets a list of domain names used in the blacklist/whitelist. You can configure multiple domain names by using prefix match. Domain names and IPs with ports are supported. Wildcard "*" is supported for second-level and third-level domain names. Container Yes
Domain DomainList Sets a single domain name used in the blacklist/whitelist, such as,, and * String Yes
EmptyReferConfiguration RefererConfiguration Indicates whether an access request without Referer is allowed. Enumerated value: Allow and Deny. It defaults to Deny. String No

Error codes

No special error message is returned for this request operation. For common error messages, see Error Codes.



GET /?referer HTTP 1.1
Date: Fri, 25 Feb 2017 04:10:22 GMT


HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 260
Connection: keep-alive
Date: Fri, 25 Feb 2017 04:10:22 GMT
Server: tencent-cos
x-cos-request-id: NTg3ZjFjMmJfOWIxZjRlXzZmNDhfMjIw