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欄位為空白的請求訪問。取值如下:
父節點:RefererConfiguration |
AllowTruncateQueryString | 枚舉字串 | true | 是否截斷URL中的QueryString。取值如下:
父節點:RefererConfiguration |
TruncatePath | 枚舉字串 | true | 是否截斷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配置資訊。 |