All Products
Search
Document Center

Object Storage Service:0033-00000005

Last Updated:Mar 20, 2026

Problem description

PutBucketReferer returns a 400 Bad Request error because the required element RefererList is missing from the XML request body.

Causes

RefererList is a required child element of RefererConfiguration. It acts as the container for Referer whitelist entries. Without it, OSS rejects the entire configuration request.

Examples

The following request fails because RefererList is absent from the XML body:

PUT /?referer HTTP/1.1
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 322
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************

<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>false</AllowEmptyReferer>
  <AllowTruncateQueryString>32</AllowTruncateQueryString>
</RefererConfiguration>

Solutions

Add RefererList to the XML request body, then resend the request:

PUT /?referer HTTP/1.1
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 322
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************

<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>false</AllowEmptyReferer>
  <AllowTruncateQueryString>false</AllowTruncateQueryString>
  <RefererList>
    <Referer>http://www.aliyun.com</Referer>
  </RefererList>
</RefererConfiguration>

References