几种特殊场景下的镜像回源规则配置_对象存储(OSS)-阿里云帮助中心

本文介绍几种特殊场景下的镜像回源配置示例。

示例一

客户A在华东1（杭州）地域创建了bucket-01，需实现如下场景：

要满足以上场景需求，请按如下步骤配置镜像回源规则：

在创建规则面板，按以下说明配置必要参数，其他参数保留默认配置。

参数	配置

参数	配置
回源类型	选中镜像。
回源条件	选中文件名前缀，并设置为examplefolder/。
替换或截取前缀	选中是否替换或截取前缀，并设置为destfolder/。说明该选项仅在设置了回源条件中的文件名前缀后显示。
回源地址	第一列设置为https，第二列设置为example.com，第三列置空。
检查MD5	选中是否检查MD5。当回源请求中返回的response包含Content-MD5字段时，OSS会检查回源文件的MD5值与Content-MD5字段值是否匹配。匹配：客户端将获取文件，且OSS保存回源文件。不匹配：由于计算MD5需要完整的文件数据，而此时文件已经透传回客户端，所以客户端能获取到文件，但OSS不会保存回源文件。

客户B在华北2（北京）地域创建了bucket-02，拥有两个目录一致的站点源站A（https://example.com）和源站B（https://example.org）需实现如下场景：

要满足以上场景需求，请参照示例一中的操作指引配置以下两条镜像回源规则：

规则一：

参数	配置

参数	配置
回源类型	选中镜像。
回源条件	选中文件名前缀，并设置为dir1/。
替换或截取前缀	选中是否替换或截取前缀，并设置为example1/。说明该选项仅在设置了回源条件中的文件名前缀后显示。
回源地址	第一列设置为https，第二列设置为example.com，第三列置空。
3xx请求响应策略	选中跟随源站重定向请求。说明未选中跟随源站重定向请求时，OSS会直接将源站重定向规则指定的地址返回给请求者。

规则二：

参数	配置

参数	配置
回源类型	选中镜像。
回源条件	选中文件名前缀，并设置为dir2。
替换或截取前缀	选中是否替换或截取前缀，并设置为example2/。说明该选项仅在设置了回源条件中的文件名前缀后显示。
回源地址	第一列设置为https，第二列设置为example.org，第三列置空。
3xx请求响应策略	选中跟随源站重定向请求。

以上规则配置完成后访问流程如下：

请求者首次访问https://bucket-02.oss-cn-beijing.aliyuncs.com/dir1/example.txt。
如果bucket-02下dir1目录中不存在example.txt文件，则OSS向https://example.com/example1/example.txt请求文件。
- 如果源站A针对example1/example.txt设置了重定向规则，则OSS会向源站重定向规则指定的地址重新发起请求，获取到文件后会将文件命名为dir1/example1/example.txt保存至bucket-02，并返回给请求者。
- 如果源站A未针对example1/example.txt设置重定向规则，则OSS获取到文件后会将文件命名为dir1/example1/example.txt保存至bucket-02，并返回给请求者。
如果请求者访问https://bucket-02.oss-cn-beijing.aliyuncs.com/dir2/example.txt，则通过镜像回源规则获取的文件将存储在bucket-02的dir2/example2目录。

客户C在华东2（上海）地域创建了bucket-03（公共读）和bucket-04（私有），需实现以下场景：

要满足以上场景需求，请参照示例一中的操作指引配置以下镜像回源规则：

参数	配置

参数	配置
回源类型	选中镜像。
回源条件	选中文件名前缀，并设置为examplefolder/。
源站类型	选中回源OSS私有Bucket，并在回源Bucket下拉列表选择bucket-04。说明配置源站类型时，OSS会在RAM服务中生成`AliyunOSSMirrorDefaultRole`角色，并授予该角色只读访问所有Bucket的权限（AliyunOSSReadOnlyAccess）。
回源地址	第一列设置为https，其他置空。
回源参数	选中携带请求字符串。 OSS会将URL请求中的query string传递到源站。
设置HTTP header传递规则	选中传递指定HTTP header参数，并添加header1、header2、header3三个HTTP header。回源规则不支持传递部分标准HTTP header，例如`authorization`、`authorization2`、`range`、`content-length`、`date`等，以及以`x-oss-`、`oss-`、`x-drs-`开头的HTTP header。重要回源私有Bucket时，请勿选择传递所有HTTP header参数，否则会导致回源失败。

以上规则配置完成后访问流程如下：

请求者首次访问https://bucket-03.oss-cn-shanghai.aliyuncs.com/examplefolder/example.png?caller=lucas&production=oss。
如果bucket-03中不存在examplefolder/example.png文件，则OSS会向https://bucket-04.oss-cn-shanghai.aliyuncs.com/examplefolder/example.png?caller=lucas&production=oss请求文件。
bucket-04会根据传递的?caller=lucas&production=oss参数，将example.png返回给OSS。
OSS会将获取的文件命名为examplefolder/example.png，并将命名后的文件存储至bucket-03。

如果请求中还携带了header1、header2、header3的HTTP header时，也会被传递到bucket-04。