您可以使用阿里云OSS的Python SDK来配置基于请求标头Referer
的访问规则,包括设置白名单Referer
、黑名单Referer
以及是否允许空Referer
。通过这些配置,您可以阻止特定Referer
访问您的OSS文件,防止其他网站盗用您的资源,从而避免不必要的流量费用增加。
注意事项
在配置防盗链之前,请确保您已了解该功能。详情请参见防盗链。
本文示例代码以华东1(杭州)的地域ID
cn-hangzhou
为例,默认使用外网Endpoint,如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系,请参见OSS地域和访问域名。要设置或清空防盗链,您必须具有
oss:PutBucketReferer
权限;要获取防盗链,您必须具有oss:GetBucketReferer
权限。具体操作,请参见为RAM用户授权自定义的权限策略。
方法定义
设置防盗链
put_bucket_referer(request: PutBucketRefererRequest, **kwargs) → PutBucketRefererResult
获取防盗链设置
get_bucket_referer(request: GetBucketRefererRequest, **kwargs) → GetBucketRefererResult
请求参数列表
参数名 | 类型 | 说明 |
request | PutBucketRefererRequest | 设置请求参数,具体请参见PutBucketRefererRequest |
GetBucketRefererRequest | 设置请求参数,具体请参见GetBucketRefererRequest |
返回值列表
类型 | 说明 |
PutBucketRefererResult | 返回值,具体请参见PutBucketRefererResult |
GetBucketRefererResult | 返回值,具体请参见GetBucketRefererResult |
关于设置防盗链方法的完整定义,请参见put_bucket_referer。
关于获取防盗链设置方法的完整定义,请参见get_bucket_referer。
示例代码
相关文档
关于防盗链的常见报错排查,请查阅33-REFERER。
关于设置防盗链的完整示例代码,请参见put_bucket_referer.py。
关于获取防盗链配置的完整示例代码,请参见get_bucket_referer.py。