镜像回源设置

最近更新时间:2021-04-19 16:46:18

查看PDF

当您的用户向KS3请求的文件不存在时,若您设置了同步回源规则,KS3会向回源地址请求这个文件,返回给用户。对于图片和视频等较大的文件,KS3会向回源地址请求部分数据,返回给用户,缩短了用户的等待时间。同时,这个文件会被存入KS3。

特别说明:

1.利用镜像回源获取数据,单个文件最大支持50GB。

2.客户最多可以配置20条回源规则。

3.拉取到KS3的数据默认以标准存储类型存储。

4.拉取到KS3的文件不支持KS3提供的设置文件名功能来修改文件名。

5.您需要联系商务或提交工单申请使用该功能才可通过控制台完成配置。

配置镜像回源

1.登录控制台,存储空间>>单击目标Bucket名称

2.空间设置>>镜像>>镜像回源

3.单击添加规则,出现添加规则弹窗,具体参数及说明如下表格所述

参数 是否必选 说明
回源 条件 1、HTTP状态码404(默认项,必选)
2、文件名前缀(可选项):通过请求的文件名前缀触发回源规则,例如:设置文件名前缀”/abc”,则访问带有/abc前缀的文件会触发这个规则(如:http://bucketname.ks3-endpoint.com/abc/image.jpg)
注意:文件名前缀不支持通配符(?*),如果您配置包含,会当作普通字符处理。
每条规则只能添加一个前缀。
回源地址 用户需在此设置回源的源地址信息。
第一列:支持选择HTTP或HTTPS,用户可以根据源站支持的访问类型进行选择。
第二列:填写源站域名或IP地址,支持配置端口。
第三列:填写目标文件所在目录信息,多级目录需以正斜线(/)隔开。例如abc/123,代表abc文件路径下的123文件夹,非必填,不填默认根目录。
注意:回源地址不支持KS3自有服务域名,包括:
1,bucektName.endpoint/path .
2.endpoint/bucektName/…
每条规则只能添加一个回源地址。
访问控制 用户可选择将源站资源自动平滑迁移到KS3的Object的权限设置为公开或私密,默认为私密
回源参数 客户可选择是否将对KS3请求中的queryString传递到源站,默认为不透传
3XX跟随策略 默认选中”是”,即跟随源站3XX重定向请求获取到资源,并且将资源保存到KS3上。若用户选择”否”,KS3会透传3XX响应给客户端,而非跟随3XX地址。
3XX包含301和302。
设置HTTP Header传递规则 默认不传递任何HTTP Header到源站,客户可以通过设置HTTP Header传递规则进行自定义透传、过滤或修改。
1.允许传递:用户可以选择“传递所有HTTP Header参数”或自定义“传递指定HTTP Header参数”(最多支持10个配置项)
2.禁止传递:用户可以选择“禁止传递指定HTTP Header参数”并且填写需要过滤的HTTP Header(最多支持10个配置项)
3.修改参数:用户可以选择“设置指定HTTP Header参数”并且填写需要修改的HTTP Header(最多支持10个配置项)

HTTP Header传递规则设置举例:
允许:传递指定HTTP header参数:reponse-content-type
禁止:禁止传递指定HTTP header参数:If-Modified-Since
设置:设置指定HTTP header参数:c-header:111

根据以上配置,若您发送到KS3的请求(HTTP Header的部分)如下:

GET /object
host : bucketname. ks3-cn-beijing.ksyun.com
response-content-type :String
If-Modified-Since : Fri, 26 Dec 2014 06:48:46 GMT
c-header : ccc

则触发镜像回源后,KS3发给源站的请求如下:

GET /object
host : source.com
response-content-type :String
c-header : 111 

注意:

以下HTTP header类型不支持设置HTTP header传递规则:

以下前缀开头的header:

  • x-kss-
  • x-ks3-

所有标准HTTP header,例如:

  • content-length
  • authorization2
  • authorization
  • range
  • date

规则优先级:设置>禁止>允许。例如:Header x-age,用户同时配置规则允许x-age,禁止x-age,且设置了header:x-age 值为1,则传递源站为x-age值为1的header。

4.单击确定。

编辑镜像回源规则

1.登录控制台,存储空间>>单击目标Bucket名称

2.空间设置>>镜像>>镜像回源

3.找到需要编辑的镜像回源规则,单击右侧的编辑

4.出现弹窗,进行编辑

删除镜像回源规则

1.登录控制台,存储空间>>单击目标Bucket名称

2.空间设置>>镜像>>镜像回源

3.找到需要编辑的镜像回源规则,单击右侧的删除

4.出现弹窗,单击确定

调整回源规则顺序

用户可以对镜像回源规则的顺序进行上移/下移操作,KS3将按照用户配置的规则展示顺序匹配规则的优先级。正常情况下,匹配到规则一,则不再匹配规则二,但是,若遇到规则一中源站不可以用时,KS3会按照第二条规则作为备源重新请求,因为规则最多配置20条,所以,我们最多有19个备站。

1.登录控制台,存储空间>>单击目标Bucket名称

2.空间设置>>镜像>>镜像回源

3.找到需要编辑的镜像回源规则,单击右侧的上移/下移更多>>上移/下移

多条规则匹配情况举例:

当客户存在多条规则且回源条件相同与部分重叠时:

规则一:回源条件全部文件404时回test.com

规则二:回源条件全部文件404时回141.0.0.12

规则三:回源条件文件名前缀为333的文件404时回back.com

KS3的处理说明:

1.请求优先匹配到规则一,同时test.com可以正常拉取数据,则不再匹配规则二。

2.请求优先匹配到规则一,但是KS3回源服务前往 test.com时,该源站不可用,则KS3再去前往规则二配置的141.0.0.12站点。

3.若规则二配置的141.0.0.12也恰巧不可用时,如果文件名符合前缀为333,则KS3继续前往规则三配置back.com;如果文件名前缀不是333,则KS3给用户返回404.

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈