全部產品
Search
文件中心

:GetBucketReferer

更新時間:Jun 19, 2024

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配置資訊。