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 枚举字符串 是否允许Referer字段为空的请求访问。

父节点:RefererConfiguration

AllowTruncateQueryString 枚举字符串 是否截断QueryString。

父节点:RefererConfiguration

RefererList 容器 保存Referer访问白名单的容器。

父节点:RefererConfiguration

子节点:Referer

Referer 字符串 Referer的访问白名单。

父节点:RefererList

此接口还涉及其他公共响应头,例如Date、x-oss-request-id等。更多

示例

请求示例

Get /?referer HTTP/1.1
Host: oss-example.oss.aliyuncs.com  
Date: Thu, 13 Sep 2012 07:51:28 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****: BuG4rRK+zNhH1AcF51NNHD39****
返回示例
  • 已设置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>false</AllowTruncateQueryString>
        <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规则的返回示例
    说明 如果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: 308  
    Server: AliyunOSS
    <?xml version="1.0" encoding="UTF-8"?>
    <RefererConfiguration>
    <AllowEmptyReferer>true</AllowEmptyReferer>
    < RefererList />
    </RefererConfiguration>

SDK

此接口所对应的各语言SDK如下:

错误码

错误码 HTTP 状态码 描述
NoSuchBucket 404 目标Bucket不存在。
AccessDenied 403 没有查看Bucket的Referer配置信息的权限。只有Bucket的拥有者才能查看Bucket的Referer配置信息。