GET Bucket Referer

Last updated: 2020-08-04 09:27:31


    This API (GET Bucket Referer) is used to read the allowlist or the blocklist 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 blocklist/allowlist. 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 blocklist/allowlist, 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

    Was this page helpful?

    Was this page helpful?

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