GetBucketReferer操作用於查看bucket的Referer相關配置。

請求文法

GET /?referer HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

響應元素(Response Elements)

表 1. 響應元素
名稱 類型 描述
RefererConfiguration 容器 保存Referer配置內容的容器。

子節點：AllowEmptyReferer節點、RefererList節點

父節點：無
AllowEmptyReferer 枚舉字元串 指定是否允許referer欄位為空的請求訪問。取值：
  • true （預設值）
  • false

父節點：RefererConfiguration
RefererList 容器 保存referer訪問白名單的容器。

父節點：RefererConfiguration

子節點：Referer
Referer 字元串 指定一條referer訪問白名單。

父節點：RefererList

細節分析

  • 如果Bucket不存在，返回404錯誤。錯誤碼：NoSuchBucket。
  • 只有Bucket的擁有者才能查看Bucket的Referer配置資訊，否則返回403 Forbidden錯誤，錯誤碼：AccessDenied。
  • 如果Bucket未進行Referer相關配置，OSS會返回預設的AllowEmptyReferer值和空的RefererList。

樣本

請求樣本：

Get /?referer HTTP/1.1
Host: oss-example.oss.aliyuncs.com  
Date: Thu, 13 Sep 2012 07:51:28 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc: BuG4rRK+zNhH1AcF51NNHD39zXw=

已設定Referer規則的返回樣本：

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906008B
Date: Thu, 13 Sep 2012 07:51:28 GMT
Connection: keep-alive
Content-Length: 218  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
<AllowEmptyReferer>true</AllowEmptyReferer >
    <RefererList>
        <Referer> http://www.aliyun.com</Referer>
        <Referer> https://www.aliyun.com</Referer>
        <Referer> http://www.*.com</Referer>
        <Referer> https://www.?.aliyuncs.com</Referer>
    </RefererList>
</RefererConfiguration>

未設定Referer規則的返回樣本：

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906008B
Date: Thu, 13 Sep 2012 07:56:46 GMT
Connection: keep-alive
Content-Length: 308  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
<AllowEmptyReferer>true</AllowEmptyReferer >
< RefererList />
</RefererConfiguration>