GetBucketReferer接口用于查看存儲空間(Bucket)的防盜鏈(Referer)相關配置。
請求語法
GET /?referer HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
當您在OSS ON云盒中調用該接口時,您需要將Host替換為云盒Endpoint。更多信息,請參見云盒Endpoint。
請求頭
此接口僅涉及公共請求頭。更多信息,請參見公共請求頭(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配置信息。 |