GetBucketReferer -

GetBucketReferer介面用於查看儲存空間（Bucket）的防盜鏈（Referer）相關配置。

請求文法

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

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

響應元素

名稱	類型	樣本值	描述
RefererConfiguration	容器	不涉及	儲存Referer配置內容的容器。父節點：無子節點：AllowEmptyReferer、AllowTruncateQueryString、RefererList
AllowEmptyReferer	枚舉字串	false	是否允許Referer欄位為空白的請求訪問。取值如下： true：允許Referer欄位為空白的請求訪問OSS。 false：不允許Referer欄位為空白的請求訪問OSS。父節點：RefererConfiguration
AllowTruncateQueryString	枚舉字串	true	是否截斷URL中的QueryString。取值如下： true：截斷QueryString。 false：不截斷QueryString。父節點：RefererConfiguration
TruncatePath	枚舉字串	true	是否截斷URL中包括Path在內的後續所有部分。取值如下： true：截斷URL中包括Path在內的後續所有部分。 false：不截斷URL中包括Path在內的後續所有部分。父節點：RefererConfiguration
RefererList	容器	不涉及	儲存Referer訪問白名單的容器。父節點：RefererConfiguration 子節點：Referer
RefererBlacklist	容器	不涉及	儲存Referer訪問黑名單的容器。父節點：RefererConfiguration 子節點：Referer
Referer	字串	http://www.aliyun.com	Referer的訪問白名單或黑名單記錄。父節點：RefererList或RefererBlacklist

此介面還涉及其他公用回應標頭，例如Date、x-oss-request-id等更多資訊，請參見公用回應標頭（Common Response Headers）。

樣本

請求樣本

Get /?referer HTTP/1.1
Host: oss-example.oss.aliyuncs.com  
Date: Thu, 13 Sep 2012 07:51:28 GMT
Authorization: OSS qn6q**************:77Dv****************

返回樣本

未設定Referer規則的返回樣本

說明

如果Bucket未進行Referer相關配置，OSS會返回預設的AllowEmptyReferer值和空的RefererList。

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 13 Sep 2012 07:56:46 GMT
Connection: keep-alive
Content-Length: ***  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>true</AllowEmptyReferer>
  < RefererList />
</RefererConfiguration>

僅設定白名單Referer規則的返回樣本

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
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>
  <AllowTruncateQueryString>true</AllowTruncateQueryString>
  <TruncatePath>true</TruncatePath>
  <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以及黑名單Referer規則的返回樣本

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 13 Sep 2012 07:51:28 GMT
Connection: keep-alive
Content-Length: ***
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
  <AllowEmptyReferer>false</AllowEmptyReferer>
  <AllowTruncateQueryString>true</AllowTruncateQueryString>
  <TruncatePath>true</TruncatePath>
  <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>
  <RefererBlacklist>
    <Referer>http://www.refuse.com</Referer>
    <Referer>https://*.hack.com</Referer>
    <Referer>http://ban.*.com</Referer>
    <Referer>https://www.?.deny.com</Referer>
  </RefererBlacklist>
</RefererConfiguration>

SDK

此介面所對應的各語言SDK如下：

錯誤碼

錯誤碼	HTTP 狀態代碼	描述
NoSuchBucket	404	目標Bucket不存在。
AccessDenied	403	沒有查看Bucket的Referer配置資訊的許可權。只有Bucket的擁有者才能查看Bucket的Referer配置資訊。