Get Bucket Referer操作用于查看Bucket防盗链的Referer相关配置。
请求语法
GET /?bucketReferer HTTP/1.1 Host: BucketName.s-bj.jcloud.com Date: GMT Date Authorization: signatureValue
名称 | 描述 |
---|---|
Effect | 黑白名单设置 类型:枚举字符串 有效值:DENIED或ALLOW ALLOW:白名单,DENIED:黑名单 |
Value | 保存名单容器 类型:List容器 |
AllowNull | 指定是否允许referer字段为空的请求访问。 有效值:TRUE(可以为空),FALSE(不可以为空) 类型:枚举字符串 |
细节分析
1.如果Bucket不存在,返回404错误。错误码:NoSuchBucket。
2.只有Bucket的拥有者才能查看Bucket的Referer配置信息,否则返回403 Forbidden错误,错误码:AccessDenied。
3.如果Bucket未进行Referer相关配置,OSS会返回默认的AllowNull值和空的Value。
请求示例
GET /?bucketReferer HTTP/1.1 Date: Tue, 11 Jul 2017 09:12:11 GMT Authorization: jingdong qbS5QXpLORrvdrmb:x7J06zQT3CJ5qF3CXKTKWjVBLvc= Host: oss-test.s-bj.jcloud.com Connection: Keep-Alive
已设置Referer规则的返回示例
HTTP/1.1 200 OK Server: nginx Date: Tue, 11 Jul 2017 09:12:10 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 43 Connection: keep-alive x-jss-request-id: A84C875C916A1E24 {"AllowNull":false,"Effect":"ALLOW","Value":["www.abc.com","www.*.com"]}
未设置Referer规则的返回示例
HTTP/1.1 204 No Content Server: nginx Date: Tue, 11 Jul 2017 09:52:11 GMT Connection: keep-alive x-jss-request-id: A4EA285FA0BCED06 {"AllowNull":false,"Effect":"ALLOW","Value":[ ]}